Vue项目依赖node服务和webpack进行打包,以pht-vue-simple项目为例分析项目打包配置及注意事项
Vue项目打包分类
本项目分为三种运行模式生产,开发,单元测试,可以分别进行配置。PS:暂时不考虑单元测试,原因都懂的。。
打包模式 | webpack配置路径 | webpack配置路径 | 打包命令 |
---|---|---|---|
pro | ./build/webpack.prod.conf | ./config/prod.env | npm run build |
dev | ./build/webpack.dev.conf | ./config/dev.env | npm run dev |
test | ./build/webpack.test.conf | ./config/test.env | npm run test |
项目打包命令
//打开项目路径
cd project-path
//开发模式
npm run dev
//生产模式
npm run build
//单元测试
npm run test
各个配置文件之间的关系
项目的配置文件的读取流程是怎样的?可以看这个文件package.json,这个文件在根目录下,这是node项目的一个重要的配置文件,记录了项目的名称,版本号,描述信息,作者,是否公开,脚本,依赖,开发依赖,运行引擎要求,浏览器支持等相关信息。
这里需要看的是scripts标签:
"scripts": {
"dev": "node build/dev-server.js",
"start": "node build/dev-server.js",
"build": "node build/build.js",
"unit": "cross-env BABEL_ENV=test karma start test/unit/karma.conf.js --single-run",
"test": "npm run unit",
"lint": "eslint --ext .js,.vue src test/unit/specs"
},
这里可以看到dev/start命令读取的是build/dev-server.js
,build读取的是build/build.js,unit/test是直接运行的karma。上面说忽略单元测试就是因为还不会karma,项目走上正轨后会用到。lint是检测代码是否有错误,是否符合规范,也算测试工具,先不考虑。
index.js
index.js路径为./config/index.js
index.js为环境运行命令入口配置文件,里面设置了开发模式和生产模式的相关配置
1. 开发模式
dev: {
//配置读取的是dev.env.js 文件,这个文件是必须有的
env: require('./dev.env'),
//端口号
port: 8080,
//编译完成启动服务后是否自动打开浏览器
autoOpenBrowser: true,
//assts资源文件的子文件夹
assetsSubDirectory: 'static',
//assets 文件夹的路径 默认为根目录
assetsPublicPath: '/',
//代理相关配置 本项目用不到
proxyTable: {},
// CSS Sourcemaps off by default because relative paths are "buggy"
// with this option, according to the CSS-Loader README
// (https://github.com/webpack/css-loader#sourcemaps)
// In our experience, they generally work as expected,
// just be aware of this issue when enabling this option.
//css资源文件对应关系Map 在/build/utils里的styleLoader中被使用为了方便调试 设置为true
cssSourceMap: true
}
2. 生产模式
build: {
//配置读取的是prod.env.js 文件,这个文件是必须有的
env: require('./prod.env'),
//访问地址后默认首页 这是编译后首页的路径
index: path.resolve(__dirname, '../dist/index.html'),
//编译后资源文件的根目录
assetsRoot: path.resolve(__dirname, '../dist'),
//编译后资源文件的子目录
assetsSubDirectory: 'static',
//编译后资源文件的访问地址
assetsPublicPath: '/',
productionSourceMap: true,
// Gzip off by default as many popular static hosts such as
// Surge or Netlify already gzip all static assets for you.
// Before setting to `true`, make sure to:
// npm install --save-dev compression-webpack-plugin
//gizp是http协议支持的一种文件压缩方式,这个怎么用我还没看
productionGzip: false,
productionGzipExtensions: ['js', 'css'],
// Run the build command with an extra argument to
// View the bundle analyzer report after build finishes:
// `npm run build --report`
// Set to `true` or `false` to always turn it on or off
bundleAnalyzerReport: process.env.npm_config_report
}
结论就是index.js 设置了开发模式和生产模式所需要的文件,下面解释prod.env.js和dev.env.js和test.env.js之间的关系
prod.env.js
module.exports = {
NODE_ENV: '"production"'
}
dev.env.js
var merge = require('webpack-merge')
var prodEnv = require('./prod.env')
module.exports = merge(prodEnv, {
NODE_ENV: '"development"'
})
test.env.js
var merge = require('webpack-merge')
var devEnv = require('./dev.env')
module.exports = merge(devEnv, {
NODE_ENV: '"testing"'
})
这里用到了webpack-merge,开发环境的配置继承了生产环境的所有配置,并对不同的部分做了修改,没修改的部分读取生产环境的,修改的部分读取开发环境的配置
build 下配置文件说明
1.build.js
读取生产模式相关配置文件和config文件夹下的文件,编译,失败输出错误日志
2.check-versions.js
检查项目的各种依赖包版本号
3.vue-loader.js
vue-loader的相关配置
4.webpack.base.conf.js
webpack打包的基础配置
5.webpack.dev.conf.js
webpack开发模式打包的基础配置
6.webpack.prod.conf.js
webpack生产模式打包的基础配置
7.webpack.test.conf.js
webpack单元测试模式打包的基础配置
8.utils.js
工具类,用于读取相关配置,不用改,没仔细看
Tips:
我也刚学这个没几天,写的不对的地方跟我说下,我改。