gulp遇到的"坑"

本文分享了在使用Gulp构建工具过程中遇到的三个常见问题及其解决方案,包括精灵图定位不准、压缩后的JS文件出现错误以及压缩过程移除低版本IE兼容代码等问题。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

在初次使用gulp时,可是遇到了几个让人头痛的”坑”,直观的以为gulp就是一个通道,把数据从一头传到了另一头,当然,管道的两头一边是我们开发使用的代码,一边是我们上线使用的代码。于是就开始了gulp的相爱相杀.


  • 问题1:精灵图定位不准
    还原事故:当时引用的是gulp-css-spriter插件,定义任务时,就是正常的定义一个task,然后引用相应的插件的方法。在写less时,并没有特意指定那个元素需当雪碧图进行引用。造成的后果就是gulp合并之后的雪碧图在页面上展示位置定位不准。
    解决方案:

    1.任务就是传统写法,如下

gulp.task('spriter', function() {
    return gulp.src(paths.css)//比如css这个样式里面什么都不用改,是你想要合并的图就要引用这个样式。
        .pipe(spriter({
            'spriteSheet': './xstatic/ximages/spritesheet.png', //这是雪碧图自动合成的图。 很重要
            'pathToSpriteSheetFromCSS': '../../ximages/spritesheet.png' //这是在css引用的图片路径,很重要
        }))
        .pipe(gulp.dest('./xstatic/xcss/css')); //最后生成出来
});

2.雪碧图的使用主要还是应用于小图标,所以我们不可能不对通过background引入的图片进行限定。 gulp-css-spriter默认会对样式文件里所有的background/background-image的图片合并,但实际项目中,我们不是所有的图片都需要合并。方法如下:

 background-image: url(../slice/p1-3.png?__spriter);//有?__spriter后缀的合并
 background-image: url(../slice/p-cao1.png); //不合并 

我们的less文件引入图片时,可以按照上述方法进行按需引用,但是需要我们修改以下文件:
node_modules\gulp-css-spriter\lib\map-over-styles-and-transform-background-image-declarations.js

48行开始的if-else if代码块中,替换为下面代码:

// background-image always has a url 且判断url是否有?__spriter后缀

                if(transformedDeclaration.property === ‘background-image‘ && /\?__spriter/i.test(transformedDeclaration.value)) {

                    transformedDeclaration.value = transformedDeclaration.value.replace(‘?__spriter‘,‘‘);
                    return cb(transformedDeclaration, declarationIndex, declarations);
                }
                // Background is a shorthand property so make sure `url()` is in there 且判断url是否有?__spriter后缀
                else if(transformedDeclaration.property === ‘background‘ && /\?__spriter/i.test(transformedDeclaration.value)) {

                    transformedDeclaration.value = transformedDeclaration.value.replace(‘?__spriter‘,‘‘);
                    var hasImageValue = spriterUtil.backgroundURLRegex.test(transformedDeclaration.value);

                    if(hasImageValue) {
                        return cb(transformedDeclaration, declarationIndex, declarations);
                    }
                }

如图:
这里写图片描述

  • 问题2:压缩后的js会出现问题,找不到使sea.jsjscmd,js,网页无法正常显示。很显然,这肯定是gulp调皮了。经查阅,发现是gulp压缩时将$ 和require等关键字也同样进行了压缩,而没有关键字的支撑,我们的页面就没有了源头,所以需要我们排除混淆关键字,解决方法如下:
gulp.task('app_scripts', function(){
   return gulp.src(paths.js) //源文件下的所有js
        .pipe(assetRev())//配置版本号
        .pipe(replace("url:'xviews", "url:'/xviews"))
        .pipe($.uglify({
           //mangle: true,//类型:Boolean 默认:true 是否修改变量名
           mangle: {except: ['require' ,'exports' ,'module' ,'$']}//排除混淆关键字
       }))
        .pipe(gulp.dest(output + "xjs"));//复制到目标文件路径
});
  • 问题3:通过gulp压缩后,低版本IE hack代码给干掉了
    还原事故:刚开始开发的时候没有过多的关注ie低版本的问题,在项目上线之前统一开始解决ie低版本兼容问题,本地测试时,均没有问题,于是就放心的打包提测了,但是一测试,发现之前改的一些ie样式没有生效,最开始我以为是less转css阶段出现问题,由于我本地测试均ok,也就说明了问题是出在css代码进行压缩的时候。所以需要我们在压缩时,添加ie兼容模式解决方法如下:
gulp.task('app_styles', function(){
   return gulp.src(paths.css)
        .pipe(assetRev())
        .pipe(replace('url("../../ximages', 'url("/xstatic/ximages'))
        .pipe($.minifyCss({
            advanced: false,//类型:Boolean 默认:true [是否开启高级优化(合并选择器等)]
            compatibility: 'ie7',//保留ie7及以下兼容写法 类型:String 默认:''or'*' [启用兼容模式; 'ie7':IE7兼容模式,'ie8':IE8兼容模式,'*':IE9+兼容模式]
        }))
        .pipe(gulp.dest(output + "xcss/css"));
});

总结:总的来说,自动化构建工具用起来还是很爽的,但是也需要我们注意其中涉及到的小点,实践中慢慢的总结吧!

04-02
### Gulp 的基本概念与使用方法 Gulp 是一种基于 Node.js 的自动化构建工具,主要用于前端开发中的任务管理。它通过流的方式处理文件,能够高效完成诸如编译 SASS、LESS 文件、压缩 JavaScript 和 CSS 文件以及优化图片等操作。 #### 安装 Gulp 为了在项目中使用 Gulp,需要先安装其全局环境和本地依赖。以下是具体的操作步骤: 1. **全局安装 Gulp CLI 工具** 这一步是为了能够在命令行中运行 `gulp` 命令。可以通过以下命令完成安装: ```bash npm install -g gulp-cli ``` 2. **在项目中安装 Gulp 作为开发依赖** 需要在具体的项目中安装 Gulp 并将其添加到 `devDependencies` 中。这可以确保不同开发者使用的 Gulp 版本一致[^2]。 ```bash npm install --save-dev gulp ``` 3. **创建 Gulpfile.js** 在项目的根目录下创建名为 `gulpfile.js` 的文件,并引入 Gulp 模块。例如: ```javascript const gulp = require('gulp'); // 定义一个简单的任务 gulp.task('default', function() { console.log('这是默认任务!'); }); ``` #### 使用插件扩展功能 Gulp 提供了许多插件来增强其能力。例如,`gulp-sass` 可以用来编译 Sass 文件,而 `gulp-uglify` 则能压缩 JavaScript 文件。下面是关于如何使用这些插件的具体说明: 1. **Sass 编译** 如果需要将 `.scss` 或 `.sass` 文件转换为普通的 CSS 文件,可以使用 `gulp-sass` 插件。首先安装该插件: ```bash npm install --save-dev gulp-sass ``` 接着,在 `gulpfile.js` 中编写相应的任务逻辑: ```javascript const sass = require('gulp-sass')(require('sass')); gulp.task('compile-sass', function () { return gulp.src('./src/scss/**/*.scss') .pipe(sass().on('error', sass.logError)) .pipe(gulp.dest('./dist/css')); }); ``` 2. **JavaScript 压缩** 对于 JavaScript 文件的压缩需求,可以选择 `gulp-uglify` 插件。需要注意的是,还需要额外安装 `pump` 来替代传统的 `.pipe()` 方法以便更好地捕获错误[^4]。 安装所需模块: ```bash npm install --save-dev gulp-uglify pump ``` 创建对应的压缩任务: ```javascript const uglify = require('gulp-uglify'); const pump = require('pump'); gulp.task('compress-js', function (cb) { pump([ gulp.src('lib/*.js'), uglify(), gulp.dest('dist/js') ], cb); }); ``` #### package.json 配置 每个使用 Gulp 的项目通常都会有一个 `package.json` 文件,其中记录了项目的元数据及其所依赖的各种包。例如,下面展示了一个典型的配置示例[^5]: ```json { "name": "example-project", "version": "1.0.0", "description": "这是一个使用 Gulp 构建的简单项目。", "main": "gulpfile.js", "scripts": { "build": "gulp" }, "author": "Your Name", "license": "MIT", "devDependencies": { "gulp": "^4.0.2", "gulp-sass": "^5.0.0", "gulp-uglify": "^3.0.2" } } ``` --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值