vue-cli中的webpack的config配置全过程

 更新时间:2026年02月09日 10:37:12   作者:神の愛  
文章详细介绍了Vue CLI中webpack的配置文件,包括`dev.env.js`和`prod.env.js`的内容,以及它们是如何通过`webpack-merge`模块进行合并的,文章还解释了这些配置文件中各个参数的作用,如`assetsSubDirectory`、`assetsPublicPath`、`proxyTable`等

vue-cli中的webpack的config配置

打开我们的vue项目文件夹我们可以清楚的看到文件夹下的三个文件,

“dev.env.js”,“index.js”,“prod.env.js”,

我们先打开prod.env.js的文件

看里面的内容:

‘use strict'
module.exports = {
NODE_ENV: ‘“production”'
}

prod.env.js的内容非常简单,仅仅是导出了一个对象,

里面写明了执行环境是“production(生产环境)”;

接下来看与之对应的“dev.env.js”文件

‘use strict'
//引入webpack-merge模块
const merge = require(‘webpack-merge')
//引入刚才打开的prod.env.js
const prodEnv = require('./prod.env')

module.exports = merge(prodEnv, {
NODE_ENV: ‘“development”'
})

在“dev.env.js”中,先引入了webpack-merge这个模块。

这个模块的作用是来合并两个配置文件对象并生成一个新的配置文件,

有点儿类似于es6的object.assign();

vue-cli中将一些通用的配置抽出来放在一个文件内,

在对不同的环境配置不同的代码,最后使用webpack-merge来进行合并,

减少重复代码,正如文档中所说,

“webpack遵循不重复原则(Don’t repeat yourself - DRY),不会再不同的环境中配置相同的代码”

当然,关于webpack-merge的内容还远不止这些,想了解更多关于这个模块的朋友请访问 https://www.npmjs.com/package/webpack-merge

好,让我们接着回到代码中来,引入webpack-merge后这个文件又引入了prod.env.js,接着就将prod.env.js的配置和新的配置,即指明开发环境(development)进行了merge。(我有点儿不太理解为什么要这样做,如果不merge直接写module.exports={NODE_ENV:’"development’}也是可以的,难道是为了优雅降级?)

还有一点需要注意是的,development和production一定要加双引号,不然会报错!!!

开头引入了node中的path模块,然后我们先来看dev下的配置内容:

  • assetsSubDirectory指的是**静态资源文件夹,默认“static”**,
  • assetsPublicPath指的是**发布路径**,
  • proxyTable是我们常用来**配置代理API的地方**,后面的host和port相信大家都知道,我就不细说了,
  • autoOpenBrowser是否自动打开浏览器
  • errorOverlay查询错误
  • notifyOnErrors通知错误

poll是跟devserver相关的一个配置,webpack为我们提供的devserver是可以监控文件改动的,但在有些情况下却不能工作,我们可以设置一个轮询(poll)来解决

  • useEslint是否使用eslint
  • showEslintErrorsInOverlay是否展示eslint的错误提示
  • devtool webpack提供的用来方便调试的配置,它有四种模式,可以查看webpack文档了解更多
  • cacheBusting 一个配合devtool的配置,当给文件名插入新的hash导致清楚缓存时是否生成souce maps,默认在开发环境下为true
  • cssSourceMap 是否开启cssSourceMap

我们再来看build下的配置内容:

  • index 编译后index.html的路径,path.resolve(__dirname, ‘…/dist’)中
  • path.resolve(__dirname)指的是index.js所在的绝对路径,再去找“…/dist”这个路径(node相关的知识),

assetsRoot打包后的文件根路径,

至于assetsSubDirectory和assetsPublicPath跟dev中的一样,

  • productionSourceMap是否开启source-map,
  • devtool同dev,
  • productionGzip是否压缩,
  • productionGzipExtensions gzip模式下需要压缩的文件的扩展名,设置后会对相应扩展名的文件进行压缩
  • bundleAnalyzerReport 是否开启打包后的分析报告

这个是配置

//config目录下index.js配置文件
// see http://vuejs-templates.github.io/webpack for documentation.
// path是node.js的路径模块,用来处理路径统一的问题
var path = require('path')
 
module.exports = {
    // 下面是build也就是生产编译环境下的一些配置
    build: {
        // 导入prod.env.js配置文件,只要用来指定当前环境,详细见(1)
        env: require('./prod.env'),
        // 下面是相对路径的拼接,假如当前跟目录是config,那么下面配置的index属性的属性值就是dist/index.html
        index: path.resolve(__dirname, '../dist/index.html'),
        // 下面定义的是静态资源的根目录 也就是dist目录
        assetsRoot: path.resolve(__dirname, '../dist'),
        // 下面定义的是静态资源根目录的子目录static,也就是dist目录下面的static
        assetsSubDirectory: 'static',
        // 下面定义的是静态资源的公开路径,也就是真正的引用路径
        assetsPublicPath: '/',
        // 下面定义是否生成生产环境的sourcmap,sourcmap是用来debug编译后文件的,通过映射到编译前文件来实现
        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
        // 下面是是否在生产环境中压缩代码,如果要压缩必须安装compression-webpack-plugin
        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
        // 下面是用来开启编译完成后的报告,可以通过设置值为true和false来开启或关闭
        // 下面的process.env.npm_config_report表示定义的一个npm_config_report环境变量,可以自行设置
        bundleAnalyzerReport: process.env.npm_config_report
    },
    dev: {
        // 引入当前目录下的dev.env.js,用来指明开发环境,详见(2)
        env: require('./dev.env'),
        // 下面是dev-server的端口号,可以自行更改
        port: 8080,
        // 下面表示是否自定代开浏览器
        autoOpenBrowser: true,
        assetsSubDirectory: 'static',
        assetsPublicPath: '/',
        // 下面是代理表,作用是用来,建一个虚拟api服务器用来代理本机的请求,只能用于开发模式
        // 详见(3)
        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文件,上面这段英文就是说使用这个cssmap可能存在问题,但是按照经验,问题不大,可以使用
        // 给人觉得没必要用这个,css出了问题,直接控制台不就完事了
        cssSourceMap: false
    }
}

(1)下面是prod.env.js的配置内容

    module.exports = {
        // 作用很明显,就是导出一个对象,NODE_ENV是一个环境变量,指定production环境
        NODE_ENV: '"production"'
    }

(2)下面是dev.env.js的配置内容

    // 首先引入的是webpack的merge插件,该插件是用来合并对象,也就是配置文件用的,相同的选项会被覆盖
    var merge = require('webpack-merge')
    // 导入prod.env.js配置文件
    var prodEnv = require('./prod.env')
    // 将两个配置对象合并,最终结果是 NODE_ENV: '"development"'
    module.exports = merge(prodEnv, {
        NODE_ENV: '"development"'
    })

(3)下面是proxyTable的一般用法

    vue-cli使用这个功能是借助http-proxy-middleware插件,一般解决跨域请求api
    proxyTable: {
        '/list': {
            target: 'http://api.xxxxxxxx.com', -> 目标url地址
            changeOrigin: true, -> 指示是否跨域
            pathRewrite: {
            '^/list': '/list' -> 可以使用 /list 等价于 api.xxxxxxxx.com/list
            }
        }
    }

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • 前端登录退出处理Token问题(获取、缓存、失效处理)及代码实现方法

    前端登录退出处理Token问题(获取、缓存、失效处理)及代码实现方法

    token是一个用户信息的表示,在登录中将会从后端拿到token,然后用户才可以进行往后的一系列操作,这篇文章主要给大家介绍了关于前端登录退出处理Token问题(获取、缓存、失效处理)及代码实现的相关资料,需要的朋友可以参考下
    2024-01-01
  • vue引用CSS样式实现手机充电效果

    vue引用CSS样式实现手机充电效果

    这篇文章主要介绍了vue引用CSS样式实现手机充电效果,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2024-01-01
  • Vue+Element一步步实现动态添加Input_输入框案例

    Vue+Element一步步实现动态添加Input_输入框案例

    这篇文章主要介绍了Vue+Element一步步实现动态添加Input_输入框案例,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-09-09
  • 详解vue之mixin的使用

    详解vue之mixin的使用

    这篇文章主要为大家介绍了vue之mixin的使用,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2021-11-11
  • Vue中Axios从远程/后台读取数据

    Vue中Axios从远程/后台读取数据

    今天小编就为大家分享一篇关于Vue中Axios从远程/后台读取数据,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-01-01
  • vue 使用 vue-pdf 实现pdf在线预览的示例代码

    vue 使用 vue-pdf 实现pdf在线预览的示例代码

    这篇文章主要介绍了vue 使用 vue-pdf 实现pdf在线预览的示例代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-04-04
  • vue中的this.$router.push()路由传值方式

    vue中的this.$router.push()路由传值方式

    这篇文章主要介绍了vue中的this.$router.push()路由传值方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-10-10
  • vue基础之模板和过滤器用法实例分析

    vue基础之模板和过滤器用法实例分析

    这篇文章主要介绍了vue基础之模板和过滤器用法,结合实例形式分析了vue模板与过滤器的功能、使用方法及相关操作注意事项,需要的朋友可以参考下
    2019-03-03
  • vue中的双向数据绑定原理与常见操作技巧详解

    vue中的双向数据绑定原理与常见操作技巧详解

    这篇文章主要介绍了vue中的双向数据绑定原理与常见操作技巧,结合实例形式详细分析了vue中双向数据绑定的概念、原理、常见操作技巧与相关注意事项,需要的朋友可以参考下
    2020-03-03
  • vue router解决路由带参数跳转时出现404问题

    vue router解决路由带参数跳转时出现404问题

    我的页面是从一个vue页面router跳转到另一个vue页面,并且利用windows.open() 浏览器重新创建一个页签,但是不知道为什么有时候可以有时候又不行,所以本文给大家介绍了vue router解决路由带参数跳转时出现404问题,需要的朋友可以参考下
    2024-03-03

最新评论