vue-cli webpack配置分析 - chenBright - SegmentFault 思否(1)

在webpack.dev.conf.js中出现webpack.base.conf.js，这个文件是开发环境和生产环境，甚至测试环境，这些环境的公共webpack配置。可以说，这个文件相当重要。

// node自带的文件路径工具

var path = require(‘path’)

// 工具函数集合

var utils = require(‘./utils’)

// 配置文件

var config = require(‘…/config’)

// 工具函数集合

var vueLoaderConfig = require(‘./vue-loader.conf’)

/**

• 获得绝对路径

• @method resolve

• @param {String} dir 相对于本文件的路径

• @return {String} 绝对路径

*/

function resolve(dir) {

return path.join(__dirname, ‘…’, dir)

}

module.exports = {

entry: {

app: ‘./src/main.js’

},

output: {

// 编译输出的静态资源根路径

path: config.build.assetsRoot,

// 编译输出的文件名

filename: ‘[name].js’,

// 正式发布环境下编译输出的上线路径的根路径

publicPath: process.env.NODE_ENV === ‘production’ ?

config.build.assetsPublicPath : config.dev.assetsPublicPath

},

resolve: {

// 自动补全的扩展名

extensions: [‘.js’, ‘.vue’, ‘.json’],

// 路径别名

alias: {

// 例如 import Vue from ‘vue’，会自动到 'vue/dist/vue.common.js’中寻找

‘vue$’: ‘vue/dist/vue.esm.js’,

‘@’: resolve(‘src’),

}

},

module: {

rules: [{

// 审查 js 和 vue 文件

// https://github.com/MoOx/eslint-loader

test: /.(js|vue)$/,

loader: ‘eslint-loader’,

// 表示预先处理

enforce: “pre”,

include: [resolve(‘src’), resolve(‘test’)],

options: {

formatter: require(‘eslint-friendly-formatter’)

}

},

{

// 处理 vue文件

// https://github.com/vuejs/vue-loader

test: /.vue$/,

loader: ‘vue-loader’,

options: vueLoaderConfig

},

{

// 编译 js

// https://github.com/babel/babel-loader

test: /.js$/,

loader: ‘babel-loader’,

include: [resolve(‘src’), resolve(‘test’)]

},

{

// 处理图片文件

// https://github.com/webpack-contrib/url-loader

test: /.(png|jpe?g|gif|svg)(?.*)?$/,

loader: ‘url-loader’,

query: {

limit: 10000,

name: utils.assetsPath(‘img/[name].[hash:7].[ext]’)

}

},

{

// 处理字体文件

test: /.(woff2?|eot|ttf|otf)(?.*)?$/,

loader: ‘url-loader’,

query: {

limit: 10000,

name: utils.assetsPath(‘fonts/[name].[hash:7].[ext]’)

}

}

]

}

}

config/index.js

该文件在很多文件中都用到，是主要的配置文件，包含静态文件的路径、是否开启sourceMap等。其中，分为两个部分dev（开发环境的配置）和build（生产环境的配置）。

// 详情见文档：https://vuejs-templates.github.io/webpack/env.html

var path = require(‘path’)

module.exports = {

// production 生产环境

build: {

// 构建环境

env: require(‘./prod.env’),

// 构建输出的index.html文件

index: path.resolve(__dirname, ‘…/dist/index.html’),

// 构建输出的静态资源路径

assetsRoot: path.resolve(__dirname, ‘…/dist’),

// 构建输出的二级目录

assetsSubDirectory: ‘static’,

// 构建发布的根目录，可配置为资源服务器域名或 CDN 域名

assetsPublicPath: ‘/’,

// 是否开启 cssSourceMap

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

// 默认关闭 gzip，因为很多流行的静态资源主机，例如 Surge、Netlify，已经为所有静态资源开启gzip

productionGzip: false,

// 需要使用 gzip 压缩的文件扩展名

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

// 运行“build”命令行时，加上一个参数，可以在构建完成后参看包分析报告

// true为开启，false为关闭

bundleAnalyzerReport: process.env.npm_config_report

},

// dev 开发环境

dev: {

// 构建环境

env: require(‘./dev.env’),

// 端口号

port: 3333,

// 是否自动打开浏览器

autoOpenBrowser: true,

assetsSubDirectory: ‘static’,

// 编译发布的根目录，可配置为资源服务器域名或 CDN 域名

assetsPublicPath: ‘/’,

// proxyTable 代理的接口（可跨域）

// 使用方法：https://vuejs-templates.github.io/webpack/proxy.html

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 Sourcemaps，因为使用相对路径会报错。

// CSS-Loader README：https://github.com/webpack/css-loader#sourcemaps

cssSourceMap: false

}

}

utils.js

utils.js也是一个被使用频率的文件，这个文件包含了三个工具函数：

• 生成静态资源的路径

• 生成 ExtractTextPlugin对象或loader字符串

• 生成 style-loader的配置

// node自带的文件路径工具

var path = require(‘path’)

// 配置文件

var config = require(‘…/config’)

// 提取css的插件

// https://github.com/webpack-contrib/extract-text-webpack-plugin

var ExtractTextPlugin = require(‘extract-text-webpack-plugin’)

/**

• 生成静态资源的路径

• @method assertsPath

• @param {String} _path 相对于静态资源文件夹的文件路径

• @return {String} 静态资源完整路径

*/

exports.assetsPath = function (_path) {

var assetsSubDirectory = process.env.NODE_ENV === ‘production’

? config.build.assetsSubDirectory

config.dev.assetsSubDirectory

// path.posix.join与path.join一样，不过总是以 posix 兼容的方式交互

return path.posix.join(assetsSubDirectory, _path)

}

/**

• 生成处理css的loaders配置

• @method cssLoaders

• @param {Object} options 生成配置

•                        option = {
  

•                          // 是否开启 sourceMap
  

•                          sourceMap: true,
  

•                          // 是否提取css
  

•                          extract: true
  

•                        }
  

• @return {Object} 处理css的loaders配置对象

*/

exports.cssLoaders = function (options) {

options = options || {}

var cssLoader = {

loader: ‘css-loader’,

options: {

minimize: process.env.NODE_ENV === ‘production’,

sourceMap: options.sourceMap

}

}

/**

• 生成 ExtractTextPlugin对象或loader字符串

• @method generateLoaders

• @param {Array} loaders loader名称数组

• @return {String|Object} ExtractTextPlugin对象或loader字符串

*/

function generateLoaders (loader, loaderOptions) {

var loaders = [cssLoader]

if (loader) {

loaders.push({

// 例如，sass?indentedSyntax

// 在?号前加上“-loader”

loader: loader + ‘-loader’,

options: Object.assign({}, loaderOptions, {

sourceMap: options.sourceMap

})

})

}

// extract为true时，提取css

// 生产环境中，默认为true

if (options.extract) {

return ExtractTextPlugin.extract({

use: loaders,

fallback: ‘vue-style-loader’

})

} else {

return [‘vue-style-loader’].concat(loaders)

}

}

// http://vuejs.github.io/vue-loader/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’)

}

}

/**

• 生成 style-loader的配置

• style-loader文档：https://github.com/webpack/style-loader

• @method styleLoaders

• @param {Object} options 生成配置

•                          option = {
  

•                            // 是否开启 sourceMap
  

•                            sourceMap: true,
  

•                            // 是否提取css
  

•                            extract: true
  

•                          }
  

• @return {Array} style-loader的配置

*/

exports.styleLoaders = function (options) {

var output = []

var loaders = exports.cssLoaders(options)

for (var extension in loaders) {

var loader = loaders[extension]

output.push({

test: new RegExp(‘\.’ + extension + ‘$’),

use: loader

})

}

return output

}

生产环境

---

开发环境的入口文件是build/build.js 。

build.js

该文件，为构建打包文件，会将源码进行构建（编译、压缩等）后打包。

// 设置当前环境为生产环境

process.env.NODE_ENV = ‘production’

// loading 插件

// https://github.com/sindresorhus/ora

var ora = require(‘ora’)

// 可以在 node 中执行rm -rf的工具

// https://github.com/isaacs/rimraf

var rm = require(‘rimraf’)

// node自带的文件路径工具

var path = require(‘path’)

// 在终端输出带颜色的文字

// https://github.com/chalk/chalk

var chalk = require(‘chalk’)

var webpack = require(‘webpack’)

// 配置文件

var config = require(‘…/config’)

var webpackConfig = require(‘./webpack.prod.conf’)

// 在终端显示loading效果，并输出提示

var spinner = ora(‘building for production…’)

spinner.start()

// 删除这个文件夹 （递归删除）

rm(path.join(config.build.assetsRoot, config.build.assetsSubDirectory), err => {

if (err) throw err

// 构建

webpack(webpackConfig, function (err, stats) {

// 构建成功

// 停止 loading动画

spinner.stop()

if (err) throw err

process.stdout.write(stats.toString({

colors: true,

modules: false,

children: false,

chunks: false,

chunkModules: false

}) + ‘\n\n’)

// 打印提示

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’

))

})

})

webpack.prod.conf

该文件，为生产环境中webpack的配置入口。同时，它也依赖于前面提到的webpack.base.conf.js、utils.js和config/index.js。

// node自带的文件路径工具

var path = require(‘path’)

// 工具函数集合

var utils = require(‘./utils’)

var webpack = require(‘webpack’)

// 配置文件

var config = require(‘…/config’)

// webpack 配置合并插件

var merge = require(‘webpack-merge’)

// webpack 基本配置

var baseWebpackConfig = require(‘./webpack.base.conf’)

// webpack 复制文件和文件夹的插件

// https://github.com/kevlened/copy-webpack-plugin

var CopyWebpackPlugin = require(‘copy-webpack-plugin’)

// 自动生成 html 并且注入到 .html 文件中的插件

// https://github.com/ampedandwired/html-webpack-plugin

var HtmlWebpackPlugin = require(‘html-webpack-plugin’)

// 提取css的插件

// https://github.com/webpack-contrib/extract-text-webpack-plugin

var ExtractTextPlugin = require(‘extract-text-webpack-plugin’)

// webpack 优化压缩和优化 css 的插件

// https://github.com/NMFR/optimize-css-assets-webpack-plugin

var OptimizeCSSPlugin = require(‘optimize-css-assets-webpack-plugin’)

// 如果当前环境为测试环境，则使用测试环境

// 否则，使用生产环境

var env = process.env.NODE_ENV === ‘testing’

? require(‘…/config/test.env’)

config.build.env

var webpackConfig = merge(baseWebpackConfig, {

module: {

// styleLoaders

rules: utils.styleLoaders({

sourceMap: config.build.productionSourceMap,

extract: true

})

},

// 是否开启 sourceMap

devtool: config.build.productionSourceMap ? ‘#source-map’ : false,

output: {

// 编译输出的静态资源根路径

path: config.build.assetsRoot,

// 编译输出的文件名

filename: utils.assetsPath(‘js/[name].[chunkhash].js’),

// 没有指定输出名的文件输出的文件名

chunkFilename: utils.assetsPath(‘js/[id].[chunkhash].js’)

},

plugins: [

// definePlugin 接收字符串插入到代码当中, 所以你需要的话可以写上 JS 的字符串

// 此处，插入适当的环境

// http://vuejs.github.io/vue-loader/en/workflow/production.html

new webpack.DefinePlugin({

‘process.env’: env

}),

// 压缩 js

new webpack.optimize.UglifyJsPlugin({

compress: {

warnings: false

},

sourceMap: true

}),

// 提取 css

new ExtractTextPlugin({

filename: utils.assetsPath(‘css/[name].[contenthash].css’)

}),

// 压缩提取出来的 css

// 可以删除来自不同组件的冗余代码

// Compress extracted CSS. We are using this plugin so that possible

// duplicated CSS from different components can be deduped.

new OptimizeCSSPlugin(),

// 将 index.html 作为入口，注入 html 代码后生成 index.html文件

// https://github.com/ampedandwired/html-webpack-plugin

new HtmlWebpackPlugin({

filename: process.env.NODE_ENV === ‘testing’

? ‘index.html’

config.build.index,

template: ‘index.html’,

inject: true,

minify: {

removeComments: true,

collapseWhitespace: true,

removeAttributeQuotes: true

// 更多选项 https://github.com/kangax/html-minifier#options-quick-reference

},

// 必须通过 CommonsChunkPlugin一致地处理多个 chunks

chunksSortMode: ‘dependency’

}),

// 分割公共 js 到独立的文件

// https://webpack.js.org/guides/code-splitting-libraries/#commonschunkplugin

new webpack.optimize.CommonsChunkPlugin({

name: ‘vendor’,

minChunks: function (module, count) {

// node_modules中的任何所需模块都提取到vendor

return (

module.resource &&

/.js$/.test(module.resource) &&

module.resource.indexOf(

path.join(__dirname, ‘…/node_modules’)

) === 0

)

}

}),

// 将webpack runtime 和模块清单 提取到独立的文件，以防止当 app包更新时导致公共 jsd hash也更新

// 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’,

chunks: [‘vendor’]

}),

// 复制静态资源

// https://github.com/kevlened/copy-webpack-plugin

new CopyWebpackPlugin([

{

from: path.resolve(__dirname, ‘…/static’),

to: config.build.assetsSubDirectory,

ignore: [‘.*’]

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数前端工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Web前端开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上前端开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注：前端）

结尾

学习html5、css、javascript这些基础知识，学习的渠道很多，就不多说了，例如，一些其他的优秀博客。但是本人觉得看书也很必要，可以节省很多时间，常见的javascript的书，例如：javascript的高级程序设计，是每位前端工程师必不可少的一本书，边看边用，了解js的一些基本知识，基本上很全面了，如果有时间可以读一些，js性能相关的书籍，以及设计者模式，在实践中都会用的到。

资料领取方式：戳这里免费获取

esolve(__dirname, ‘…/static’),

to: config.build.assetsSubDirectory,

ignore: [‘.*’]

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数前端工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Web前端开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

[外链图片转存中…(img-TYmOZYIg-1713568523463)]

[外链图片转存中…(img-HsPmcwBs-1713568523464)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上前端开发知识点，真正体系化！

[外链图片转存中…(img-eWs59KVJ-1713568523464)]

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注：前端）

[外链图片转存中…(img-RZYwo1J4-1713568523464)]

结尾

学习html5、css、javascript这些基础知识，学习的渠道很多，就不多说了，例如，一些其他的优秀博客。但是本人觉得看书也很必要，可以节省很多时间，常见的javascript的书，例如：javascript的高级程序设计，是每位前端工程师必不可少的一本书，边看边用，了解js的一些基本知识，基本上很全面了，如果有时间可以读一些，js性能相关的书籍，以及设计者模式，在实践中都会用的到。

资料领取方式：戳这里免费获取