该webpack版本号为3.6.0
这段时间以来,项目一直都是用Vue全家桶及vue-cli,于是便把vue-cli配置文件给整理了以下,希望对大家能有所帮助。
├─build
│ ├─build.js
│ ├─check-versions.js
│ ├─logo.png
│ ├─utils.js
│ ├─vue-loader.conf.js
│ ├─webpack.base.conf.js
│ ├─webpack.dev.conf.js
│ ├─webpack.prod.conf.js
├─config
│ ├─dev.env.js
│ ├─index.js
│ ├─prod.env.js
├─…
└─package.json
文章主要对生产环境和开发环境以及打包所相关的文件进行分析。
首先看package.json里面的scripts字段。
"scripts": {
"dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",
"start": "npm run dev",
"build": "node build/build.js"
},
npm run dev 这里默认执行的是开发环境。
开发环境和生产环境区别
开发环境(development)和生产环境(production)的构建目标差异很大。在开发环境中,我们需要具有强大的、具有实时重新加载(live reloading)或热模块替换(hot module replacement)能力的 source map 和 localhost server。而在生产环境中,我们的目标则转向于关注更小的 bundle,更轻量的 source map,以及更优化的资源,以改善加载时间。由于要遵循逻辑分离,我们通常建议为每个环境编写彼此独立的 webpack 配置。
3.1 build/webpack.dev.conf.js
当执行npm run dev时,我们执行的就是该js文件,该文件主要完成以下任务:
1.引入相关插件和配置
2.生成处理各种样式的规则
3.配置开发环境,如热更新、监听端口号,是否自动打开浏览器等都在webpack中的devServer中配置完成
4.寻找可利用的端口和添加显示程序编译运行时的错误信息。
文件内容如下(一些插件和语句的具体作用见注释):
'use strict'
const utils = require('./utils')
// utils提供工具函数,包括生成处理各种样式语言的loader,获取资源文件存放路径的工具函数。
const webpack = require('webpack')
// 引入webpack模块
const config = require('../config')
// 默认是index文件
const merge = require('webpack-merge')
// 将基础配置和开发环境配置或者生产环境配置合并在一起的包管理
const baseWebpackConfig = require('./webpack.base.conf')
// 引入基本webpack基本配置
const HtmlWebpackPlugin = require('html-webpack-plugin')
// 文件名及时更改,自动打包并且生成响应的文件在index.html里面
// 传送门:https://webpack.js.org/plugins/html-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
const FriendlyErrorsPlugin = require('friendly-errors-webpack-plugin')
// Friendly-errors-webpack-plugin可识别某些类型的webpack错误并清理,汇总和优先化它们以提供更好的开发者体验。
// 传送门:http://npm.taobao.org/package/friendly-errors-webpack-plugin
const portfinder = require('portfinder')
// 查看空闲端口位置,默认情况下搜索8000这个端口,
// 传送门:https://www.npmjs.com/package/portfinder
const HOST = process.env.HOST
//processs为node的一个全局对象获取当前程序的环境变量,即host,
// 传送门:http://javascript.ruanyifeng.com/nodejs/process.html#toc5
const PORT = process.env.PORT && Number(process.env.PORT) //
//processs为node的一个全局对象获取当前程序的环境变量,即host,
// 传送门:http://javascript.ruanyifeng.com/nodejs/process.html#toc5
const devWebpackConfig = merge(baseWebpackConfig, {
module: {
rules: utils.styleLoaders({ sourceMap: config.dev.cssSourceMap, usePostCSS: true })
//自动生成了css,postcss,less等规则,并进行模块转换,转换成webpack可识别的文件,进行解析转换
},
devtool: config.dev.devtool,
// 增加调试信息
// 传送门:https://doc.webpack-china.org/configuration/devtool
devServer: {
clientLogLevel: 'none',
// 在开发工具(DevTools)的控制台将显示消息【如:在重新加载之前,在一个错误之前,或者模块热替换(HMR)启动时,这可能显示得很繁琐】
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-clientloglevel
historyApiFallback: true,
// 当使用 HTML5 History API 时,任意的 404 响应都可能需要被替代为 index.html。
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-historyapifallback
hot: true,
// 启动模块热更新特性
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-hot
compress: true,
// 一切服务都启动用gzip方式进行压缩代码
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-compress
host: HOST || config.dev.host,
// 指定使用一个host,默认是localhost,获取HOST地址,该文件定义或config中index里的dev配置里获取
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-host
port: PORT || config.dev.port,
// 指定要监听的端口号
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-port
open: config.dev.autoOpenBrowser,
// 发开服务器是否自动代开默认浏览器
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-open
overlay: config.dev.errorOverlay
? { warnings: false, errors: true }
: false,
// 当出现编译器错误或警告时,在浏览器中显示全屏叠加,覆盖到浏览器的项目页面的上方。{warning:false,errors:true}这个选项为 显示错误和警告
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-overlay
publicPath: config.dev.assetsPublicPath,
// 服务器假设运行在http://localhost:8080并且output.filename被设置为bundle.js默认。publicPath是"/",所以你的包(束)通过可以http://localhost:8080/bundle.js访问。
// 比如将config中的index.js dev对象的中的assertsPublicPath设置为"/asserts/"那么文件打开后将通过http://localhost:8080/asserts/来进行访问
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-publicpath-
proxy: config.dev.proxyTable,
// 如果你有单独的后端开发服务器API,并且希望在同域名下发送API请求,那么代理某些URL将很有用.简称就是API代理,中间件 需引入 http-proxy-middleware
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-proxy
quiet: false, // necessary for FriendlyErrorsPlugin
// 启用quiet后,除了初始启动信息之外的任何内容都不会被打印到控制台。这也意味着来自的WebPack的错误或警告在控制台不可见。
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-quiet-
watchOptions: {
poll: config.dev.poll,
}
// webpack使用文件系统(file system)获取文件改动的通知
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-watchoptions-
},
plugins: [
new webpack.DefinePlugin({
'process.env': require('../config/dev.env')
}),
// 将DefinePlugin允许您创建可在配置全局常量的编译时间。这对于允许开发构建和发布构建之间的不同行为是有用的
// 传送门:https://webpack.js.org/plugins/define-plugin/#src/components/Sidebar/Sidebar.jsx
new webpack.HotModuleReplacementPlugin(),
// 永远不能用在生产模式,模块热更新,修改文件的内容,允许在运行时更新各种模块,而无需进行完全刷新。
// 传送门:https://doc.webpack-china.org/guides/hot-module-replacement/
new webpack.NamedModulesPlugin(),
// 当进行热更新时,相关文件名会被展示出来
// 传送门:https://webpack.js.org/plugins/named-modules-plugin/#src/components/Sidebar/Sidebar.jsx
new webpack.NoEmitOnErrorsPlugin(),
// 跳过编译时出错的代码并记录,使编译后运行时的包不会发生错误。
// 传送门:https://webpack.js.org/plugins/no-emit-on-errors-plugin/#src/components/Sidebar/Sidebar.jsx
new HtmlWebpackPlugin({
filename: 'index.html',
template: 'index.html',
inject: true
}),
// 该插件可自动生成一个 html5 文件或使用模板文件将编译好的代码注入进去
// 传送门:https://webpack.js.org/plugins/html-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
// https://github.com/ampedandwired/html-webpack-plugin
]
})
module.exports = new Promise((resolve, reject) => {
portfinder.basePort = process.env.PORT || config.dev.port
//由于portfinder这个插件本身是从8000开始查找,这里设置查找的默认端口号
portfinder.getPort((err, port) => {
if (err) {
reject(err)
} else {
// publish the new Port, necessary for e2e tests
process.env.PORT = port
// 如果端口被占用就对进程设置端口
devWebpackConfig.devServer.port = port
// 如果端口被占用就设置devServer的端口
// Add FriendlyErrorsPlugin
devWebpackConfig.plugins.push(new FriendlyErrorsPlugin({
compilationSuccessInfo: {
messages: [`Your application is running here: http://${devWebpackConfig.devServer.host}:${port}`],
},
// 添加提示信息,所在域名和端口的提示信息
onErrors: config.dev.notifyOnErrors
? utils.createNotifierCallback()
: undefined
}))
// 窗口提示信息,调用utils工具函数的createNotifierCallBack()方法
resolve(devWebpackConfig)
// 如果找到能用的端口号,就把配置信息提示抛出去
}
})
})
3.2 build/webpack.base.conf.js
从webpack.dev.conf.js来看文件中引入了utils.js工具类函数和config文件夹中的index.js环境配置模块,以及引入了webpack.base.conf.js基础(开发和生产环境公共)配置。所以这里先分析webpack.base.conf.js文件。
webpack.base.conf.js主要完成了下面这些事件:
1.配置webpack编译入口
2.配置webpack输出路径和命名规则
3.配置模块resolve规则
4.配置不同类型模块的处理规则
文件内容如下(一些插件和语句的具体作用见注释):
'use strict'
const path = require('path')
// node.js的文件路径,用来处理文件当中的路径问题
// 传送门:http://www.jianshu.com/p/fe41ee02efc8
const utils = require('./utils')
//引入utils.js模块
const config = require('../config')
// 默认是index文件,引入index.js模块
const vueLoaderConfig = require('./vue-loader.conf')
// vue-loader.conf配置文件是用来解决各种css文件的,定义了诸如css,less,sass之类的和样式有关的loader
function resolve(dir) {
return path.join(__dirname, '..', dir)
}
// 此函数是用来返回当前目录的平行目录的路径,因为有个'..'
module.exports = {
context: path.resolve(__dirname, '../'),
//基础目录(绝对路径),用于从配置中解析入口点和加载程序
// 传送门:https://webpack.js.org/configuration/entry-context/#context
entry: {
app: './src/main.js'
},
// 定义入口文件
output: {
path: config.build.assetsRoot,
// 打包生成的出口文件所放的位置
filename: '[name].js',
// 打包生成app.js文件
publicPath: process.env.NODE_ENV === 'production' ?
config.build.assetsPublicPath : config.dev.assetsPublicPath
// 项目上线地址,也就是真正的文件引用路径,如果是production环境,其实这里都是'/'
// path和publicPath的区别传送门:https://www.webpackjs.com/concepts/output/
},
resolve: {
extensions: ['.js', '.vue', '.json'],
// 省略扩展名,比方说import index from '../js/index'会默认去找index文件,然后找index.js,index.vue,index.json文件
alias: {
'vue$': 'vue/dist/vue.esm.js',
'@': resolve('src'),
}
// 使用别名 使用上面的resolve函数,意思就是用@代替src的绝对路径
},
module: {
rules: [{
test: /\.vue$/,
loader: 'vue-loader',
options: vueLoaderConfig
},
{
test: /\.js$/,
loader: 'babel-loader',
include: [resolve('src'), resolve('test')]
},
{
test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
loader: 'url-loader',
options: {
limit: 10000,
name: utils.assetsPath('img/[name].[hash:7].[ext]')
}
},
{
test: /\.(mp4|webm|ogg|mp3|wav|flac|aac)(\?.*)?$/,
loader: 'url-loader',
options: {
limit: 10000,
name: utils.assetsPath('media/[name].[hash:7].[ext]')
}
},
{
test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/,
loader: 'url-loader',
options: {
limit: 10000,
name: utils.assetsPath('fonts/[name].[hash:7].[ext]')
}
}
]
},
// 不同文件模块使用不同的loader
node: {
setImmediate: false,
dgram: 'empty',
fs: 'empty',
net: 'empty',
tls: 'empty',
child_process: 'empty'
}
//这些选项可以配置是否 polyfill 或 mock 某些 Node.js 全局变量和模块。这可以使最初为 Node.js 环境编写的代码,在其他环境(如浏览器)中运行.
//传送门:http://www.css88.com/doc/webpack/configuration/node/
}
3.3 build/utils.js
utils提供工具函数,包括生成处理各种样式语言的loader,获取资源文件存放路径的工具函数。
1. 计算资源文件存放路径
2. 生成cssLoaders用于加载.vue文件中的样式
3. 生成styleLoaders用于加载不在.vue文件中的单独存在的样式文件
4. 处理程序在编译过程中出现的错误,并在桌面进行错误信息的提示
文件内容如下(一些插件和语句的具体作用见注释):
'use strict'
const path = require('path')
// node.js的文件路径,用来处理文件当中的路径问题
// 传送门:http://www.jianshu.com/p/fe41ee02efc8
const config = require('../config')
// 引入config中的index.js文件
const ExtractTextPlugin = require('extract-text-webpack-plugin')
// extract-text-webpack-plugin可以提取bundle中的特定文本,将提取后的文本单独存放到另外的文件
// 传送门:https://webpack.js.org/plugins/extract-text-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
const packageConfig = require('../package.json')
// 引入包的json文件
exports.assetsPath = function (_path) {
const assetsSubDirectory = process.env.NODE_ENV === 'production' ?
config.build.assetsSubDirectory :
config.dev.assetsSubDirectory
return path.posix.join(assetsSubDirectory, _path)
// path.posix以posix兼容的方式交互,是跨平台的,如果是path.win32的话,只能在win上
// 传送们:https://nodejs.org/api/path.html#path_path_posix
}
// 资源存放的路径,区别在于生产环境和开发环境
exports.cssLoaders = function (options) {
options = options || {}
const cssLoader = {
loader: 'css-loader',
options: {
sourceMap: options.sourceMap
// 是否使用sourceMap
// 传送门:https://webpack.js.org/loaders/css-loader/#src/components/Sidebar/Sidebar.jsx
}
}
const postcssLoader = {
loader: 'postcss-loader',
options: {
sourceMap: options.sourceMap
// 是否使用sourceMap,postcss-loader用来解决各浏览器的前缀问题
// 传送门:https://webpack.js.org/loaders/postcss-loader/#src/components/Sidebar/Sidebar.jsx
}
}
function generateLoaders(loader, loaderOptions) {
const loaders = options.usePostCSS ? [cssLoader, postcssLoader] : [cssLoader]
// 判断将cssLoader和postcssLoader推入loaders数组
if (loader) {
loaders.push({
loader: loader + '-loader',
options: Object.assign({}, loaderOptions, {
sourceMap: options.sourceMap
})
})
}
// 处理各种各样的loader,并且将各种各样的loader推入loaders数组当中去
if (options.extract) {
return ExtractTextPlugin.extract({
use: loaders,
fallback: 'vue-style-loader'
})
}
//如果options.extract存在,则用extract-text-plugin提取样式
else {
return ['vue-style-loader'].concat(loaders)
}
// 无需提取样式则简单使用vue-style-loader配合各种样式loader去处理vue当中的<style>里面的样式
// 传送门:https://vue-loader.vuejs.org/en/configurations/extract-css.html
}
return {
css: generateLoaders(),
postcss: generateLoaders(),
less: generateLoaders('less'),
sass: generateLoaders('sass', {
indentedSyntax: true
}),
scss: generateLoaders('sass'),
stylus: generateLoaders('stylus'),
styl: generateLoaders('stylus')
}
}
// cssLoaders将各种loader 转成对象形式以便styleLoaders进行处理
exports.styleLoaders = function (options) {
const output = []
const loaders = exports.cssLoaders(options)
// 调用cssLoaders方法
// 这时的usePostCSS存在
for (const extension in loaders) {
const loader = loaders[extension]
output.push({
test: new RegExp('\\.' + extension + '$'),
use: loader
})
}
return output
}
// styleLoaders进行再加工处理
// 生成处理单独的.css、.sass、.scss等样式文件的规则
exports.createNotifierCallback = () => {
const notifier = require('node-notifier')
return (severity, errors) => {
if (severity !== 'error') return
const error = errors[0]
// 每次捕获第一个错误
const filename = error.file && error.file.split('!').pop()
// 错误文件的名称所在位置
notifier.notify({
title: packageConfig.name,
// 错误提示项目名字
message: severity + ': ' + error.name,
// 错误提示类型
subtitle: filename || '',
// 错误提示副标题
icon: path.join(__dirname, 'logo.png')
// 错误提示图示标
})
}
}
// 引入node-notifier模块,这个模块是用来在桌面窗口提示信息,如果想要关闭直接return掉或者在webpack.dev.conf.js中关掉
// 传送门:https://www.npmjs.com/package/node-notifier
3.4 build/vue-loader.js
该文件的主要作用就是处理.vue文件,解析这个文件中的每个语言块(template、script、style),转换成js可用的js模块。
1. 配置vue-loader,将一些遇见的文件转换成可供webpack进行模块化处理。
文件内容如下(一些插件和语句的具体作用见注释):
'use strict'
const utils = require('./utils')
// 引入utils.js相关模块
const config = require('../config')
// 默认是index.js文件
const isProduction = process.env.NODE_ENV === 'production'
//判断是否为生产环境
const sourceMapEnabled = isProduction ?
config.build.productionSourceMap :
config.dev.cssSourceMap
//判定特定环境下sourceMap的值
module.exports = {
loaders: utils.cssLoaders({
sourceMap: sourceMapEnabled,
extract: isProduction
// 是否将样式提取到单独的文件
}),
cssSourceMap: sourceMapEnabled,
// 是否开启cssSourceMap, 关闭可以避免 css-loader 的 some relative path related bugs 同时可以加快构建速度。
// 传送门:https://vue-loader.vuejs.org/zh-cn/options.html#csssourcemap
cacheBusting: config.dev.cacheBusting,
// 是否通过将哈希查询附加到文件名来生成具有缓存清除的源映射[疑问,求解]
// 传送门:https://vue-loader.vuejs.org/en/options.html#cachebusting
transformToRequire: {
video: ['src', 'poster'],
source: 'src',
img: 'src',
image: 'xlink:href'
}
// 在模版编译过程中,编译器可以将某些属性,如 src 路径,转换为 require 调用,以便目标资源可以由 webpack 处理.
// 传送门:https://vue-loader.vuejs.org/zh-cn/options.html#transformtorequire
}
3.5 build/webpack.prod.conf.js
构建的时候用到的webpack配置来自webpack.prod.conf.js,该配置同样是在webpack.base.conf基础上的进一步完善。主要完成下面几件事情:
1.合并基础的webpack配置
2.配置样式文件的处理规则,styleLoaders
3.配置webpack的输出
4.配置webpack插件
5.gzip模式下的webpack插件配置
6.webpack-bundle分析
文件内容如下(一些插件和语句的具体作用见注释):
'use strict'
const path = require('path')
// node.js的文件路径,用来处理文件当中的路径问题
// 传送门:http://www.jianshu.com/p/fe41ee02efc8
const utils = require('./utils')
//引入utils.js模块
const webpack = require('webpack')
// 引入webpack模块
const config = require('../config')
// 默认是index文件,引入index.js模块
const merge = require('webpack-merge')
// 将基础配置和开发环境配置或者生产环境配置合并在一起的包管理
const baseWebpackConfig = require('./webpack.base.conf')
// 引入基本webpack基本配置
const CopyWebpackPlugin = require('copy-webpack-plugin')
// 在webpack中拷贝文件和文件夹
// 传送门:https://doc.webpack-china.org/plugins/copy-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
const HtmlWebpackPlugin = require('html-webpack-plugin')
// 文件名即使更改,自动打包并且生成响应的文件在index.html里面
// 传送门:https://webpack.js.org/plugins/html-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
const ExtractTextPlugin = require('extract-text-webpack-plugin')
// 它会将所有的入口 chunk(entry chunks)中引用的 *.css,移动到独立分离的 CSS 文件
// https://doc.webpack-china.org/plugins/extract-text-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
const OptimizeCSSPlugin = require('optimize-css-assets-webpack-plugin')
//一个用来压缩优化CSS大小的东西
// 传送门:http://npm.taobao.org/package/optimize-css-assets-webpack-plugin
const UglifyJsPlugin = require('uglifyjs-webpack-plugin')
// 一个用来压缩优化JS大小的东西
// 传送门:https://webpack.js.org/plugins/uglifyjs-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
const env = require('../config/prod.env')
// 引入生产环境
const webpackConfig = merge(baseWebpackConfig, {
module: {
rules: utils.styleLoaders({
sourceMap: config.build.productionSourceMap,
extract: true,
usePostCSS: true
})
},
// 将webpack基本配置和生产环境配置合并在一起,生成css,postcss,less等规则,并进行模块转换,转换成webpack可识别的文件,进行解析
// 将CSS提取到单独文件中去
devtool: config.build.productionSourceMap ? config.build.devtool : false,
// 是否使用sourcemap
output: {
path: config.build.assetsRoot,
// 文件打包的输出路径
filename: utils.assetsPath('js/[name].[chunkhash].js'),
// 主文件入口文件名字
chunkFilename: utils.assetsPath('js/[id].[chunkhash].js')
// 非主文件入口文件名,可以存放cdn的地址
// 传送门:http://react-china.org/t/webpack-output-filename-output-chunkfilename/2256
},
plugins: [
// http://vuejs.github.io/vue-loader/en/workflow/production.html
new webpack.DefinePlugin({
'process.env': env
}),
// DefinePlugin 允许创建一个在编译时可以配置的全局常量。这可能会对开发模式和发布模式的构建允许不同的行为非常有用。
// https://doc.webpack-china.org/plugins/define-plugin/#src/components/Sidebar/Sidebar.jsx
new UglifyJsPlugin({
uglifyOptions: {
compress: {
warnings: false
}
},
sourceMap: config.build.productionSourceMap,
parallel: true
}),
// 一个用来压缩优化JS大小的东西
// 传送门:https://webpack.js.org/plugins/uglifyjs-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
new ExtractTextPlugin({
filename: utils.assetsPath('css/[name].[contenthash].css'),
allChunks: false,
}),
// 它会将所有的入口 chunk(entry chunks)中引用的 *.css,移动到独立分离的 CSS 文件
// https://doc.webpack-china.org/plugins/extract-text-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
new OptimizeCSSPlugin({
cssProcessorOptions: config.build.productionSourceMap ? {
safe: true,
map: {
inline: false
}
} : {
safe: true
}
}),
//一个用来压缩优化CSS大小的东西
// 传送门:http://npm.taobao.org/package/optimize-css-assets-webpack-plugin
new HtmlWebpackPlugin({
filename: config.build.index,
template: 'index.html',
inject: true,
minify: {
removeComments: true,
// 删除index.html中的注释
collapseWhitespace: true,
// 删除index.html中的空格
removeAttributeQuotes: true
// 删除各种html标签属性值的双引号
},
chunksSortMode: 'dependency'
// 注入依赖的时候按照依赖先后顺序进行注入,比如,需要先注入vendor.js,再注入app.js
}),
new webpack.HashedModuleIdsPlugin(),
// 该插件会根据模块的相对路径生成一个四位数的hash作为模块id, 建议用于生产环境。
// 传送门:https://doc.webpack-china.org/plugins/hashed-module-ids-plugin/#src/components/Sidebar/Sidebar.jsx
new webpack.optimize.ModuleConcatenationPlugin(),
// 预编译所有模块到一个闭包中,提升你的代码在浏览器中的执行速度。
// 传送门:https://doc.webpack-china.org/plugins/module-concatenation-plugin/#src/components/Sidebar/Sidebar.jsx
new webpack.optimize.CommonsChunkPlugin({
name: 'vendor',
minChunks(module) {
// any required modules inside node_modules are extracted to vendor
return (
module.resource &&
/\.js$/.test(module.resource) &&
module.resource.indexOf(
path.join(__dirname, '../node_modules')
) === 0
)
}
}),
// 将所有从node_modules中引入的js提取到vendor.js,即抽取库文件
// extract webpack runtime and module manifest to its own file in order to
// prevent vendor hash from being updated whenever app bundle is updated
new webpack.optimize.CommonsChunkPlugin({
name: 'manifest',
minChunks: Infinity
}),
// 把webpack的runtime和manifest这些webpack管理所有模块交互的代码打包到[name].js文件中,防止build之后vendor的hash值被更新[疑问]
// 传送门:https://webpack.js.org/plugins/commons-chunk-plugin/#extra-async-commons-chunk
new webpack.optimize.CommonsChunkPlugin({
name: 'app',
async: 'vendor-async',
children: true,
minChunks: 3
}),
// 传送门:https://webpack.js.org/plugins/commons-chunk-plugin/#extra-async-commons-chunk
new CopyWebpackPlugin([{
from: path.resolve(__dirname, '../static'),
to: config.build.assetsSubDirectory,
ignore: ['.*']
}])
// 在webpack中拷贝文件和文件夹
// 传送门:https://doc.webpack-china.org/plugins/copy-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
]
})
if (config.build.productionGzip) {
const CompressionWebpackPlugin = require('compression-webpack-plugin')
webpackConfig.plugins.push(
new CompressionWebpackPlugin({
asset: '[path].gz[query]',
algorithm: 'gzip',
test: new RegExp(
'\\.(' +
config.build.productionGzipExtensions.join('|') +
')$'
),
threshold: 10240,
minRatio: 0.8
})
)
}
// 提供带 Content-Encoding 编码的压缩版的资源
// 传送门:https://doc.webpack-china.org/plugins/compression-webpack-plugin/#src/components/Sidebar/Sidebar.jsx
if (config.build.bundleAnalyzerReport) {
const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin
webpackConfig.plugins.push(new BundleAnalyzerPlugin())
}
// 分析 bundle 内容的插件及 CLI 工具,以便捷的、交互式、可缩放的树状图形式展现给用户。
// 传送门:https://github.com/webpack-contrib/webpack-bundle-analyzer
module.exports = webpackConfig
3.6 build/check-versions.js
若要执行build.js构建打包文件,必须先进行npm和node版本的检测。
1.进行npm、node版本检查(版本不相对时,会出现无法打包,某些文件无法正常编译运行的情况)
文件内容如下(一些插件和语句的具体作用见注释):
'use strict'
const chalk = require('chalk')
// chalk插件,他的作用是在控制台中输出不同的颜色的字,大致这样用chalk.blue('Hello world'),这款插件只能改变命令行中的字体颜色
// 传送门:https://github.com/chalk/chalk
const semver = require('semver')
// npm版本号的检查
// 传送门:https://docs.npmjs.com/misc/semver
const packageConfig = require('../package.json')
// 引入包的json文件
const shell = require('shelljs')
// shelljs插件,作用是用来执行Unix系统命
function exec(cmd) {
return require('child_process').execSync(cmd).toString().trim()
}
//脚本可以通过child_process 模块新建子进程,从而执行 Unix 系统命令
//这段代码实际就是把cmd这个参数传递的值转化成前后没有空格的字符串,也就是版本号
const versionRequirements = [
{
name: 'node',
currentVersion: semver.clean(process.version),
// 当前node版本信息
versionRequirement: packageConfig.engines.node
//package.json里面所要求的node版本信息
}
]
// 检查node版本信息。
// 一:使用semver插件把版本信息转化成规定格式,也就是 ' =v1.2.3 ' -> '1.2.3' 这种功能
// 二:这是规定的pakage.json中engines选项的node版本信息 "node":">= 4.0.0"
if (shell.which('npm')) {
versionRequirements.push({
name: 'npm',
currentVersion: exec('npm --version'),
// 动调用npm --version命令,检查版本信息
versionRequirement: packageConfig.engines.npm
// 规定要求的npm版本信息
})
}
// 检查npm版本信息
// 一:自动调用npm --version命令,并且把参数返回给exec函数,从而获取纯净的版本号
// 二:这是规定的pakage.json中engines选项的node版本信息 "npm": ">= 3.0.0"
module.exports = function () {
const warnings = []
for (let i = 0; i < versionRequirements.length; i++) {
const mod = versionRequirements[i]
if (!semver.satisfies(mod.currentVersion, mod.versionRequirement)) {
warnings.push(mod.name + ': ' +
chalk.red(mod.currentVersion) + ' should be ' +
chalk.green(mod.versionRequirement)
)
}
}
// 进行版本检查,这里主要用到semver的模块,semver.satisfies(version,range),如果版本不在这个范围内,则进行报错
// range eg:
// ^1.2.3 := >=1.2.3 <2.0.0
// ^0.2.3 := >=0.2.3 <0.3.0
// ^0.0.3 := >=0.0.3 <0.0.4
if (warnings.length) {
console.log('')
console.log(chalk.yellow('To use this template, you must update following to modules:'))
console.log()
for (let i = 0; i < warnings.length; i++) {
const warning = warnings[i]
console.log(' ' + warning)
}
console.log()
process.exit(1)
// 能否正常的运行dev-server
// 传送门:http://javascript.ruanyifeng.com/nodejs/process.html#toc9
// process.exit方法用来退出当前进程。它可以接受一个数值参数,如果参数大于0,表示执行失败;如果等于0表示执行成功。
}
}
3.7 build/build.js
构建环境下的配置,执行”npm run build”的时候首先执行的是build/build.js文件,build.js主要完成下面几件事。
1. 进行node和npm的版本检查
2. 打包时产生loading动画
3. 删除目标文件夹
4. 输出打包信息
文件内容如下(一些插件和语句的具体作用见注释):
'use strict'
require('./check-versions')()
// 进行npm和node版本检查
process.env.NODE_ENV = 'production'
// 当前node的环境变量设置为production
const ora = require('ora')
// cnpm run build显示的进度条
// 传送门:https://github.com/sindresorhus/ora
const rm = require('rimraf')
// 用于删除文件或者文件夹的插件,
// 传送门:https://github.com/isaacs/rimraf
const path = require('path')
// node.js的文件路径,用来处理文件当中的路径问题
// 传送门:http://www.jianshu.com/p/fe41ee02efc8
const chalk = require('chalk')
// chalk插件,他的作用是在控制台中输出不同的颜色的字,大致这样用chalk.blue('Hello world'),这款插件只能改变命令行中的字体颜色
// 传送门:https://github.com/chalk/chalk
const webpack = require('webpack')
// 引入webpack模块
// 传送门:https://github.com/webpack/webpack
const config = require('../config')
// 引入config中的index.js文件
const webpackConfig = require('./webpack.prod.conf')
// 引入webpack生产环境配置
const spinner = ora('building for production...')
// 填写打包时所显示的提示信息
spinner.start()
// 开启loading动画
rm(path.join(config.build.assetsRoot, config.build.assetsSubDirectory), err => {
// node.js将文件目录拼接起来,默认是/dist/static
if (err) throw err
webpack(webpackConfig, (err, stats) => {
spinner.stop()
if (err) throw err
process.stdout.write(stats.toString({
colors: true,
modules: false,
children: false,
chunks: false,
chunkModules: false
}) + '\n\n')
// process.stdout.write这一串是控制打包后详细文件的输出情况
if (stats.hasErrors()) {
console.log(chalk.red(' Build failed with errors.\n'))
process.exit(1)
}
// 打包失败,显示错误信息,并退出程序
console.log(chalk.cyan(' Build complete.\n'))
console.log(chalk.yellow(
' Tip: built files are meant to be served over an HTTP server.\n' +
' Opening index.html over file:// won\'t work.\n'
))
// 打包成功在控制台上显示打包成功提示信息
})
})
4.1 config/index.js
config文件夹下,最主要的就是index.js文件,保存着开发环境和生产环境所需要的信息。
文件内容如下(一些插件和语句的具体作用见注释):
'use strict'
// Template version: 1.2.5
// see http://vuejs-templates.github.io/webpack for documentation.
// 这个文件描述了开发和生产环境的配置
const path = require('path')
// node.js的文件路径,用来处理文件当中的路径问题
// 传送门:http://www.jianshu.com/p/fe41ee02efc8
module.exports = {
dev: {
assetsSubDirectory: 'static',
// 二级目录,存放静态资源文件的目录,位于dist文件夹下
assetsPublicPath: '/',
// 发布路径,如果构建后的产品文件有用于CDN或者放到其他域名服务器,可以在这里设置,当然本地打包,本地浏览一般都将这里设置为"./"
// 设置之后的构建的产品在注入到index.html中就会带上这里的发布路径
proxyTable: {},
// 代理示例: proxy: [{context: ["/auth", "/api"],target: "http://localhost:3000",}]
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-proxy
// 各种开发服务器的配置
host: 'localhost',
// 这个可以被process.env.HOST重写
port: 8080,
// process.env.PORT重写 在端口空闲的情况下
autoOpenBrowser: true,
// 是否自动打开浏览器
errorOverlay: true,
// 当出现编译器错误或警告时,在浏览器中显示全屏叠加,覆盖到浏览器的项目页面的上方。{warning:false,errors:true}这个选项为 显示错误和警告
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-overlay
notifyOnErrors: true,
// 是否允许窗口弹出错误信息
// 传送门:https://www.npmjs.com/package/node-notifier
poll: false,
// webpack使用文件系统(file system)获取文件改动的通知
// 传送门:https://doc.webpack-china.org/configuration/dev-server/#devserver-watchoptions-
useEslint: true,
// 如果使用了eslint,您的代码将在捆绑和连接错误和警告将在控制台中显示。
showEslintErrorsInOverlay: false,
// 如果使用了eslint,违反eslint规则的错误和警告也将被显示在浏览器的透明黑色层上面
devtool: 'eval-source-map',
// 开启调试的类型
//传送门: https://webpack.js.org/configuration/devtool/#development
cacheBusting: true,
// 是否通过将哈希查询附加到文件名来生成具有缓存清除的源映射[疑问,求解]
// 传送门:https://vue-loader.vuejs.org/en/options.html#cachebusting
cssSourceMap: false,
// 开发环境下,不显示cssSourceMap
},
build: {
index: path.resolve(__dirname, '../dist/index.html'),
// 获得绝对路径,inde.html的模板文件
// 传送门:http://javascript.ruanyifeng.com/nodejs/path.html#toc1
assetsRoot: path.resolve(__dirname, '../dist'),
// 获得dist文件夹的绝对路径
// 传送门:http://javascript.ruanyifeng.com/nodejs/path.html#toc1
assetsSubDirectory: 'static',
// 二级目录
assetsPublicPath: '/',
// 发布路径,如果构建后的产品文件有用于CDN或者放到其他域名服务器,可以在这里设置,当然本地打包,本地浏览一般都将这里设置为"./"
// 设置之后的构建的产品在注入到index.html中就会带上这里的发布路径
productionSourceMap: true,
// production环境下生成sourceMap文件
// 传送门:https://webpack.js.org/configuration/devtool/#production
devtool: '#source-map',
// 开启调试的类型
//传送门: https://webpack.js.org/configuration/devtool/#development
productionGzip: false,
productionGzipExtensions: ['js', 'css'],
// gzip模式下需要压缩的文件的扩展名,设置js、css之后就只会对js和css文件进行压
bundleAnalyzerReport: process.env.npm_config_report
// 是否展示webpack构建打包之后的分析报告
}
}
4.2 config/dev.env.js
该文件主要来设置开发环境变量。
文件内容如下(一些插件和语句的具体作用见注释):
'use strict'
const merge = require('webpack-merge')
// 引入webpack-merge模块
// 传送门:https://doc.webpack-china.org/guides/production/
const prodEnv = require('./prod.env')
// 引入生产环境配置
module.exports = merge(prodEnv, {
NODE_ENV: '"development"'
})
// 配置NODE_ENV来决定开发环境
// 这个就是用来上线的时候用到,来决定是开发环境还是生产环境,来进行相关的配置解决方案
4.2 config/prod.env.js
该文件主要来设置生产环境变量。
文件内容如下(一些插件和语句的具体作用见注释):
'use strict'
module.exports = {
NODE_ENV: '"production"'
}
//NODE_ENV决定生产环境
相信通过大家对以上内容阅读,已经对vue-cli有个大概的了解,希望能在大家配置项目时有所帮助。
参考文章(部分):
vue-cli的webpack模板项目配置文件分析:http://blog.csdn.net/hongchh/article/details/55113751
vue-cli webpack配置分析:https://segmentfault.com/a/1190000008644830
vue-cli脚手架之webpack.prod.conf.js:https://www.cnblogs.com/hongdiandian/p/8319514.html
浅谈Vue-cli 命令行工具分析: http://www.jb51.net/article/128838.htm
webpack中output配置项中chunkFilename属性的用法:https://www.cnblogs.com/toward-the-sun/p/6147324.html?utm_source=itdadao&utm_medium=referral