使用gulp搭建一个传统的多页面前端项目的开发环境

• 支持pug scss es6编译支持
• 支持开发环境和打包生成sourceMap
• 支持文件变动自动刷新浏览器，css是热更新（css改动无需刷新浏览器即可更新）
• 支持新增文件没无需重启gulp，即可改动自动刷新浏览器
• 支持命令生成雪碧图和对应css
• 支持eslint，使用的eslint插件是eslint-config-alloy
• 支持打包html，css，js图片压缩，css中小图片转base64
• 支持css，js文件版本hash值，文件无变动则版本hash不会改变，更好利用缓存
• 支持html中的css，js，img路径添加cdn域名前缀，css中的图片链接建议使用相对路径
• 支持代理，便于跨域调试

（1） git clone https://github.com/lfyfly/dev-easy.git或者下载 zip包

（2）删除项目下的因此目录.git文件夹，这是我的commit记录，所以删除

（3）npm install 安装依赖

（4）npm run dev

进入开发模式

打包命令

打包并且以dist为根目录开启服务器查看效果

把根目录下的sprites文件夹下的子目录内的所有文件夹中的png和jpg的图片，以子文件夹目录为单位生产雪碧图，文件名为子目录名

• 当img的src为http开头则会被忽略该处理
• 当img的className中包含not-webp开头则会被忽略该处理

eslint检测

eslint修复

src是源码目录，可以通过config.srcPath进行配置，以下src只目录只是个例子，代表源码目录

静态文件目录

第三方js，css，iconfont等

scss模块目录，里面的.scss文件不会被单独编译成css文件

pug模块目录，里面的.pug文件不会被单独编译成html文件

该目录里面的.pug,.scss文件不会被单独编译成html文件

根目录下的config.js

module.exports = {
  srcPath: 'src',
  pug: true,
  scss: true,
  babel: true,
  tmpPath: 'node_modules/__tmp__',
  build: {
    htmlmin: true,
    cssmin: true,
    jsmin: true,
    base64: 10 * 1024, // (bytes) 使用css中图片使用相对路径，否者无效
    cssSourcemap: true,
    jsSourcemap: true,
    cdn: 'http://your/cdn/url/',
    versionHash: true, // 版本hash
  },
  proxyTable: {
    '/api': 'http://localhost:3000',
    '/hehe': {
      target: 'http://localhost:3000',
      pathRewrite: {
        // 地址重写
        '^/hehe': '/api'
      }
    }
  }
}

如不需要使用某个配置项目，直接将其注释即可

配置目录源文件目录，默认为'src'

• 值为true时，会开启对src目录内所有的.pug文件（除src/_pug/外）编译成html
• src/_pug作为pug的模块目录，不会被单独编译为html文件

• 值为true时，会开启对src内所有的.scss,.sass文件（除src/_scss外）编译成scss
• src/_scss/作为scss的模块目录，不会被单独编译为css文件

• 值为true时，会开启对src目录内所有的.js文件（除src/static/vendor/外）编译成es5
• babel配置文件，根目录下.babelrc文件

• 默认值为 'node_modules/__tmp__'

• npm run dev作为.pug，.scss，.js文件编译的临时文件目录，和src同为静态文件目录，且优先级高于src目录

  browserSync.init({
      server: {
        baseDir: [config.tmpPath, 'src'],
      },
      middleware,
      port: 9000,
      online: false
    })
  
  

• 编译后文件访问：src/static/public/public.scss在html的访问路径为/static/public/public.css

• 每次运行npm run dev config.tmpPath都会被清理

  proxyTable: {
    '/api': 'http://localhost:3000',
    '/hehe': {
      target: 'http://localhost:3000',
      pathRewrite: {
        // 地址重写
        '^/hehe': '/api'
      }
    }
  }

使用html,css,js构建项目

使用pug(可选用),scss,js构建项目 将config.srcPath值设为src-1即可切换到该项目

推荐使用sea.js或require.js进行模块管理

推荐使用编辑器插件进行提示，还可以配置保存时自动修复eslint

// 当前环境为开发环境
var isDev = !!document.getElementById('__bs_script__')

注意： isDev只能在body标签内的js中这样获取，或者在DOMContenLoaded或load事件回调中初始化 isDev