Vue前端vue.config.js简介
难自拔于世界之大 人气:0vue.config.js
vue项目的配置文件,需要严格遵照 JSON 的格式来写。结构如下:
module.exports = { // 选项... }
publicPath
部署应用包时的基本 URL。例如 https://www.my-app.com/,则publicPath
则为“/”,如果应用被部署在 https://www.my-app.com/my-app/,则设置 publicPath 为 /my-app/。
outputDir
当运行 vue-cli-service build 时生成的生产环境构建文件的目录。注意目标目录的内容在构建之前会被清除 (构建时传入 --no-clean 可关闭该行为)。
assetsDir
放置生成的静态资源 (js、css、img、fonts) 的 (相对于 outputDir 的) 目录。
devServer
在开发环境下API 请求的代理到 API 服务器。这个问题可以通过 vue.config.js 中的 devServer.proxy 选项来配置。生产环境一般由Nginx负责。
process.env.VUE_APP_BASE_API
由于我们的项目需要在不同环境下进行运行(开发,生产,测试等),这避免我们需要多次的去切换请求的地址以及相关的配置,vue-cli2是可以直接在config文件中进行配置的,但是vue-cli4和vue-cli3已经简化了,没有config文件怎么办?
建立.env系列文件
首先我们在根目录新建3个文件,分别为.env.development,.env.production,.env.test
注意文件是只有后缀的。
.env.development 模式用于serve,开发环境,就是开始环境的时候会引用这个文件里面的配置
.env.production模式用于build,线上环境。
.env.test 测试环境
PS:vue.config.js详解
vue.config.js 是一个可选的配置文件,如果项目的 (和 package.json 同级的) 根目录中存在这个文件,那么它会被 @vue/cli-service 自动加载。你也可以使用 package.json 中的 vue 字段,但是注意这种写法需要你严格遵照 JSON 的格式来写。
这个文件应该导出一个包含了选项的对象:
// vue.config.js module.exports = { //默认情况下,Vue CLI 会假设你的应用是被部署在一个域名的根路径上,例如 https://www.my-app.com/。如果应用被部署在一个子路径上,你就需要用这个选项指定这个子路径。例如,如果你的应用被部署在 https://www.my-app.com/my-app/,则设置 publicPath 为 /my-app/。 //这个值也可以被设置为空字符串 ('') 或是相对路径 ('./') publicPath: './', outputDir:"dist",//当运行 vue-cli-service build 时生成的生产环境构建文件的目录名字 默认为"dist" assetsDir: './static',//当运行 vue-cli-service build 时生成的生成的静态资源 (js、css、img、fonts) 的 (相对于 outputDir 的) 目录 默认为"",默认与生成的index.html同级 indexPath:"index.html",//npm run build之后生成的入口文件 默认为index.html,此属性可以省略,省略了默认就是index.html filenameHashing:true,//默认情况下,生成的静态资源在它们的文件名中包含了 hash 以便更好的控制缓存。然而,这也要求 index 的 HTML 是被 Vue CLI 自动生成的。如果你无法使用 Vue CLI 生成的 index HTML,你可以通过将这个选项设为 false 来关闭文件名哈希。 pages: { index: { // page 的入口 entry: 'src/index/main.js', // 模板来源 template: 'public/index.html', // 在 dist/index.html 的输出 filename: 'index.html', // 当使用 title 选项时, // template 中的 title 标签需要是 <title><%= htmlWebpackPlugin.options.title %></title> title: 'Index Page', // 在这个页面中包含的块,默认情况下会包含 // 提取出来的通用 chunk 和 vendor chunk。 chunks: ['chunk-vendors', 'chunk-common', 'index'] }, // 当使用只有入口的字符串格式时, // 模板会被推导为 `public/subpage.html` // 并且如果找不到的话,就回退到 `public/index.html`。 // 输出文件名会被推导为 `subpage.html`。 subpage: 'src/subpage/main.js' }, //lintOnSave: //1.是否在开发环境下通过 eslint-loader 在每次保存时 lint 代码。这个值会在 @vue/cli-plugin-eslint 被安装之后生效。 //2.设置为 true 时,eslint-loader 会将 lint 错误输出为编译警告。默认情况下,警告仅仅会被输出到命令行,且不会使得编译失败。 //3.如果你希望让 lint 错误在开发时直接显示在浏览器中,你可以使用 lintOnSave: 'error'。这会强制 eslint-loader 将 lint 错误输出为编译错误,同时也意味着 lint 错误将会导致编译失败。 //4.或者,你也可以通过设置让浏览器 overlay 同时显示警告和错误: //module.exports = { //devServer: { //overlay: { // warnings: true, // errors: true //} //} //} lintOnSave:true, runtimeCompiler:false,//是否使用包含运行时编译器的 Vue 构建版本。设置为 true 后你就可以在 Vue 组件中使用 template 选项了,但是这会让你的应用额外增加 10kb 左右。 transpileDependencies:[],//默认情况下 babel-loader 会忽略所有 node_modules 中的文件。如果你想要通过 Babel 显式转译一个依赖,可以在这个选项中列出来。 productionSourceMap:true,//如果你不需要生产环境的 source map,可以将其设置为 false 以加速生产环境构建 这玩意设置成false之后,能把打包后的文件大小减小80% 当时我的项目大小是8m+ 设成false之后变成了2m+ productionSourceMap:false,之后,就不会生成map文件,map文件的作用在于:项目打包后,代码都是经过压缩加密的,如果运行时报错,输出的错误信息无法准确得知是哪里的代码报错。也就是说map文件相当于是查看源码的一个东西。如果不需要定位问题,并且不想被看到源码,就把productionSourceMap 置为false,既可以减少包大小,也可以加密源码。 crossorigin:"undefined",//设置生成的 HTML 中 <link rel="stylesheet"> 和 <script> 标签的 crossorigin 属性。需要注意的是该选项仅影响由 html-webpack-plugin 在构建时注入的标签 - 直接写在模版 (public/index.html) 中的标签不受影响。 integrity:false,//在生成的 HTML 中的 <link rel="stylesheet"> 和 <script> 标签上启用 Subresource Integrity (SRI)。如果你构建后的文件是部署在 CDN 上的,启用该选项可以提供额外的安全性。需要注意的是该选项仅影响由 html-webpack-plugin 在构建时注入的标签 - 直接写在模版 (public/index.html) 中的标签不受影响。另外,当启用 SRI 时,preload resource hints 会被禁用,因为 Chrome 的一个 bug 会导致文件被下载两次。 configureWebpack:Object | Function,//下面举个例子: configureWebpack: config => { if (process.env.NODE_ENV === "production") { // 为生产环境修改配置... config.mode = "production"; // 这里修改下 config.optimization.minimizer = [ new UglifyJsPlugin({ uglifyOptions: { compress: { warnings: false, drop_console: true, //console drop_debugger: true, pure_funcs: ['console.log'] //移除console } } }) ] //打包文件大小配置 config["performance"] = { "maxEntrypointSize":10000000, "maxAssetSize":30000000 } } else { // 为开发环境修改配置... config.mode = "development"; } }, //上面是统一使用configureWebpack的函数模式,然后函数模式里面默认会有一个config参数,需要增加或者修改configureWebpack对应的参数,就直接使用config去修改就可以了! //我这里使用了两个功能,第一个是打包build的时候去掉console的调试信息,第二个就是修改打包静态资源文件大小设置的配置 chainWebpack:function,//是一个函数,会接收一个基于 webpack-chain 的 ChainableConfig 实例。允许对内部的 webpack 配置进行更细粒度的修改。下面举个例子 chainWebpack: config => { config.resolve.alias .set('@', resolve('src'))//设置@快捷到src目录 .set('view', resolve('src/view'))//设置view快捷指定到src/view目录 .set('$css',resolve('/static/css')) .set('$common',resolve('/components')) .set('$api',resolve('/api')) .set('$page',resolve('/pages')) .set('$js',resolve('/static/js')); // 删除预加载 config.plugins.delete('preload') config.plugins.delete('prefetch') // 压缩代码 config.optimization.minimize(true) // 分割代码 config.optimization.splitChunks({ chunks: 'all' }) }, css:{ modules:false,//默认情况下,只有 *.module.[ext] 结尾的文件才会被视作 CSS Modules 模块。设置为 true 后你就可以去掉文件名中的 .module 并将所有的 *.(css|scss|sass|less|styl(us)?) 文件视为 CSS Modules 模块。 extract:true,//Default: 生产环境下是 true,开发环境下是 false 是否将组件中的 CSS 提取至一个独立的 CSS 文件中 (而不是动态注入到 JavaScript 中的 inline 代码)。 sourceMap:false,//是否为 CSS 开启 source map。设置为 true 之后可能会影响构建的性能。 loaderOptions:{},//向 CSS 相关的 loader 传递选项。例如: }, devServer:{ proxy:'http://localhost:8080',//如果你的前端应用和后端 API 服务器没有运行在同一个主机上,你需要在开发环境下将 API 请求代理到 API 服务器。这个问题可以通过 vue.config.js 中的 devServer.proxy 选项来配置。http://localhost:8080这会告诉开发服务器将任何未知请求 (没有匹配到静态文件的请求) 代理到http://localhost:4000 如果你想要更多的代理控制行为,也可以使用一个 path: options 成对的对象。完整的选项可以查阅 http-proxy-middleware 。 proxy: { '/rng': { target: '<url>',// 后台接口域名 secure: false, // 如果是https接口,需要配置这个参数 ws: true,//如果要代理 websockets,配置这个参数 changeOrigin: true//是否跨域 //我的 api='/rng'我的请求地址 ${api}/xxxx/xxx ,请求地址就为 '/rng/xxxx/xxx'当node服务器 遇到 以 '/rng' 开头的请求,就会把 target 字段加上,那么我的请求地址就为 http://45.105.124.130:8081/rng/xxxx/xxx }, '/foo': { target: '<other_url>' } } }, parallel:'boolean',//是否为 Babel 或 TypeScript 使用 thread-loader。该选项在系统的 CPU 有多于一个内核时自动启用,仅作用于生产构建。 pluginOptions:{ //less全局变量引用 'style-resources-loader': { preProcessor: 'less', patterns: [ path.resolve(__dirname, './src/assets/varibles.less'), ] } }, },
加载全部内容