如何编写一个完整的vue.config.js配置文件？

本文共计2405个文字，预计阅读时间需要10分钟。

目录+ 引言

1.介绍

查看默认的webpack配置：vue.config.js文件

2.基本配置

3.插件及规则的配置

+ 规则rules的配置 3.1 rules的新增 3.2 rules的修改 + 插件plugins的配置 5.1 plugins的新增 5.2 plugins的修改

目录

• 引言
• 1 介绍
• 查看默认的webpack配置
• vue.config.js文件
• 2 基本配置
• 3 插件及规则的配置
• 4 规则rules的配置
• 4.1 rules的新增
• 4.2 rules的修改
• 5 插件plugins 的配置
• 5.1 plugins的新增
• 5.2 plugins的修改
• 5.3 plugins的删除
• 6 一些常见的配置
• 6.1 修改enter文件
• 6.2 DefinePlugin
• 6.3 自定义filename 及 chunkFilename
• 6.4 修改html-webpack-plugin参数
• 6.5 设置别名alias
• 7 附上一份我的vue.config.js的配置

引言

前段时间，对部门的个别项目进行Vue3.0+ts框架的迁移，刚开始研究的时候也是踩坑特别多，尤其我们的项目还有些特殊的webpack配置，所以，研究vue.config.js的配置的时候也是查阅了各种资料文档，最终，完成了项目webpack的特殊配置。

今天分享一下，我们项目当中的一些webpack配置，希望能给大家有所启发；只要配置多了，你就会发现其实所有的配置的都是相似的，尤其像插件的配置，都是十分相似的。

我们现在开始进入今天的主题啦~~

1 介绍

之前，我有提到过，当然大家肯定也都知道，Vue3.0不在有webpack.config.js的配置；但是不可避免,在项目开发中我们肯定会存在一些特殊的需求需要调整webpack, 这个时候，在Vue3.0的项目当中，我们就需要在根目录创建vue.config.js去完成webpack的一些特殊配置,默认它会被@vue/cli-service自动加载。

此刻，你需要创建vue.config.js文件。

查看默认的webpack配置

Vue CLI 官方文档：vue-cli-service暴露了inspect命令用于审查解析好的webpack配置。

那个全局的 vue 可执行程序同样提供了inspect命令，这个命令只是简单的把vue-cli-service``inspect代理到了你的项目中。

被抽象化的webpack，我们要想去理解它默认的一些配置的话是比较困难的，所以我们可以通过指令去查看。

该指令会将webpack的配置输出到output.js文件，这样方便去查看。

vue inspect > output.js

vue.config.js文件

这个文件导出了一个包含了选项的对象：

module.exports = { // 选项... }

接下来，详细介绍一些选项及配置：

2 基本配置

module.exports = { productionSourceMap: false, publicPath: './', outputDir: 'dist', assetsDir: 'assets', devServer: { port: 8090, host: '0.0.0.0', ip:port/...访问你的项目

https: 是否启用https

open:npm run serve时是否直接打开浏览器

3 插件及规则的配置

在vue.config.js如果要新增/修改webpack的plugins或者rules, 有2种方式。

configureWebpack方式

configureWebpack 是相对比较简单的一种方式

• 它可以是一个对象：和webpack本身配置方式是一致，该对象将会被webpack-merge合并入最终的webpack配置
• 它也可以是一个函数：直接在函数内部进行修改配置

configureWebpack: { rules:[], plugins: [] } configureWebpack: (config) => { // 例如，通过判断运行环境，设置mode config.mode = 'production' }

chainWebpack方式

chainWebpack 链式操作 (高级)，接下来所有的配置我都会在该选项中进行配置

4 规则rules的配置

关于rules的配置，我会分别从新增/修改进行介绍。

4.1 rules的新增

在webpack中rules是module的配置项，而所有的配置的都是挂载到config下的，所以新增一个rule方式：

config.module .rule(name) .use(name) .loader(loader) .options(options)

案例：style-resources-loader来添加less全局变量

案例：svg-sprite-loader将svg图片以雪碧图的方式在项目中加载

module.exports = { chainWebpack: (config) => { // 通过 style-resources-loader 来添加less全局变量 const types = ['vue-modules', 'vue', 'normal-modules', 'normal']; types.forEach(type => { let rule = config.module.rule('less').oneOf(type) rule.use('style-resource') .loader('style-resources-loader') .options({ patterns: [path.resolve(__dirname, './lessVariates.less')] }); }); // `svg-sprite-loader`: 将svg图片以雪碧图的方式在项目中加载 config.module .rule('svg') .test(/.svg$/) // 匹配svg文件 .include.add(resolve('src/svg')) // 主要匹配src/svg .end() .use('svg-sprite-loader') .loader('svg-sprite-loader') // 使用的loader，主要要npm该插件 .options({symbolId: 'svg-[name]'}) // 参数配置 } }

4.2 rules的修改

针对已经存在的rule, 如果需要修改它的参数, 可以使用tap方法：

config.module .rule(name) .use(name) .tap(options => newOptions)

案例：修改url-loader的参数

module.exports = { chainWebpack: (config) => { // `url-loader`是webpack默认已经配置的，现在我们来修改它的参数 config.module.rule('images') .use('url-loader') .tap(options => ({ name: './assets/images/[name].[ext]', quality: 85, limit: 0, esModule: false, })) } }

5 插件plugins 的配置

关于plugins的配置，我会分别从新增/修改/删除进行介绍。

5.1 plugins的新增

• 注意：这里WebpackPlugin不需要通过new WebpackPlugin()使用。

config .plugin(name) .use(WebpackPlugin, args)

案例：新增hot-hash-webpack-plugin

const HotHashWebpackPlugin = require('hot-hash-webpack-plugin'); module.exports = { chainWebpack: (config) => { // 新增一个`hot-hash-webpack-plugin` // 注意：这里use的时候不需要使用`new HotHashWebpackPlugin()` config.plugin('hotHash') .use(HotHashWebpackPlugin, [{ version: '1.0.0' }]); } }

5.2 plugins的修改

同理,plugin参数的修改也是通过tap去修改。

config .plugin(name) .tap(args => newArgs)

案例：修改打包后css抽离后的filename及抽离所属目录

案例：删除console和debugger

const HotHashWebpackPlugin = require('hot-hash-webpack-plugin'); module.exports = { chainWebpack: (config) => { // 修改打包时css抽离后的filename及抽离所属目录 config.plugin('extract-css') .tap(args => [{ filename: 'css/[name].[contenthash:8].css', chunkFilename: 'css/[name].[contenthash:8].css' }]); // 正式环境下，删除console和debugger config.optimization .minimize(true) .minimizer('terser') .tap(args => { let { terserOptions } = args[0]; terserOptions.compress.drop_console = true; terserOptions.compress.drop_debugger = true; return args }); } }

5.3 plugins的删除

对于一些webpack默认的plugin，如果不需要可以进行删除

config.plugins.delete(name)

案例：删除vue-cli3.X模块的自动分割抽离

module.exports = { chainWebpack: (config) => { // vue-cli3.X 会自动进行模块分割抽离，如果不需要进行分割,可以手动删除 config.optimization.delete('splitChunks'); } }

6 一些常见的配置

6.1 修改enter文件

webpack默认的entry入口是scr/main.ts

config.entryPoints.clear(); // 清空默认入口 config.entry('test').add(getPath('./test/main.ts')); // 重新设置

6.2 DefinePlugin

定义全局全局变量，DefinePlugin是webpack已经默认配置的，我们可以对参数进行修改

config.plugin('define').tap(args => [{ ...args, "window.isDefine": JSON.stringify(true), }]);

6.3 自定义filename 及 chunkFilename

自定义打包后js文件的路径及文件名字

config.output.filename('./js/[name].[chunkhash:8].js'); config.output.chunkFilename('./js/[name].[chunkhash:8].js');

6.4 修改html-webpack-plugin参数

html-webpack-plugin是webpack已经默认配置的，默认的源模版文件是public/index.html;我们可以对其参数进行修改

config.plugin('html') .tap(options => [{ template: '../../index.html' // 修改源模版文件 title: 'test', }]);

6.5 设置别名alias

webpack默认是将src的别名设置为@, 此外，我们可以进行添加

config.resolve.alias .set('@', resolve('src')) .set('api', resolve('src/apis')) .set('common', resolve('src/common'))

7 附上一份我的vue.config.js的配置

const path = require('path'); const HotHashWebpackPlugin = require('hot-hash-webpack-plugin'); const WebpackBar = require('webpackbar'); const resolve = (dir) => path.join(__dirname, '.', dir); module.exports = { productionSourceMap: false, publicPath: './', outputDir: 'dist', assetsDir: 'assets', devServer: { port: 9999, host: '0.0.0.0', https: false, open: true }, chainWebpack: (config) => { const types = ['vue-modules', 'vue', 'normal-modules', 'normal']; types.forEach(type => { let rule = config.module.rule('less').oneOf(type) rule.use('style-resource') .loader('style-resources-loader') .options({ patterns: [path.resolve(__dirname, './lessVariates.less')] }); }); config.resolve.alias .set('@', resolve('src')) .set('api', resolve('src/apis')) .set('common', resolve('src/common')) config.module.rule('images').use('url-loader') .tap(options => ({ name: './assets/images/[name].[ext]', quality: 85, limit: 0, esModule: false, })); config.module.rule('svg') .test(/.svg$/) .include.add(resolve('src/svg')) .end() .use('svg-sprite-loader') .loader('svg-sprite-loader'); config.plugin('define').tap(args => [{ ...args, "window.isDefine": JSON.stringify(true) }]); // 生产环境配置 if (process.env.NODE_ENV === 'production') { config.output.filename('./js/[name].[chunkhash:8].js'); config.output.chunkFilename('./js/[name].[chunkhash:8].js'); config.plugin('extract-css').tap(args => [{ filename: 'css/[name].[contenthash:8].css', chunkFilename: 'css/[name].[contenthash:8].css' }]); config.plugin('hotHash').use(HotHashWebpackPlugin, [{ version : '1.0.0'}]); config.plugin('webpackBar').use(WebpackBar); config.optimization.minimize(true) .minimizer('terser') .tap(args => { let { terserOptions } = args[0]; terserOptions.compress.drop_console = true; terserOptions.compress.drop_debugger = true; return args }); config.optimization.splitChunks({ cacheGroups: { common: { name: 'common', chunks: 'all', minSize: 1, minChunks: 2, priority: 1 }, vendor: { name: 'chunk-libs', chunks: 'all', test: /[\/]node_modules[\/]/, priority: 10 } } }); } } };

以上就是vue.config.js 的完整配置的详细内容，更多关于vue.config.js配置的资料请关注易盾网络其它相关文章！