Vue的 vue.config.js 配置

avatar
作者
筋斗云
阅读量:0

简介:

vue.config.js 是一个可选的配置文件,如果项目的根目录中存在这个文件,那么它会被 @vue/cli-service 自动加载。也可以使用 package.json 中的 vue 字段,但是注意这种写法需要你严格遵照 JSON 的格式来写。

详细配置官方文档:配置参考 | Vue CLI

内部配置详解:

每次在用的时候都是直接从网上找一个复制下来,用到哪个地方修改哪里,但是一直不知道具体是怎么操作,这次总结下.

module.exports = {   publicPath: '/', // 部署应用包时的基本 URL ,默认'/'   outputDir: 'dist',// 构建输出目录   assetsDir: 'static',// 静态资源目录   lintOnSave: process.env.NODE_ENV === 'development' ? 'error' : false,   productionSourceMap: false, // 生产环境 source map   devServer: { ...},// 配置 webpack-dev-server 行为。   configureWebpack: {...}, // 配置 Webpack   chainWebpack(config) {.....} // 调整内部的 webpack 配置。 }

以下写的是部分常用配置:看全部请看官方文档

publicPath#

  • Type: string

  • Default: '/'

1.部署的基础路径(就是你上线的时候服务器的ip,比如http://10.170.6.111The domain name My-App.com is for salehttp://10.170.6.111)默认假设你的应用将会部署在域名的根部

2.如果你的应用时部署在一个子路径下,那么你需要在这里 指定子路径。比如,如果你的应用部署在 https://www.foobar.com/my-app/

3.这个值也可以"./"是相对路径 不过尽量不要

outputDir#

  • Type: string

  • Default: 'dist'

不建议动,这个就是npm run build打包后生成文件的目录

indexPath#

  • Type: string

  • Default: 'index.html'

    指定生成的 index.html 的输出路径 (相对于 outputDir)。也可以是一个绝对路径。

pages#

  • Type: Object

  • Default: undefined

在 multi-page (多页面应用)模式下构建应用。每个“page”应该有一个对应的 JavaScript 入口文件。其值应该是一个对象,对象的 key 是入口的名字,value 是

拓展:
单页面应用(spa)

概念:只有一个html页面,所有跳转方式都是通过组件切换完成的。
优点:页面之间跳转流畅、组件化开发、组件可复用、开发便捷、易维护。
缺点:首屏加载较慢,加载整个项目中使用的css、js,SEO优化不好。

多页面应用(mpa)

概念:整个项目有多个html,所有跳转方式都是页面之间相互跳转的。
优点:首屏加载较快,只加载本页所使用的的css、js,SEO优化较好。
缺点:页面跳转较慢。

module.exports = {   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#

  • Type: boolean | 'warning' | 'default' | 'error'

  • Default: 'default'

1.在 开发模式下 通过eslint-loader(eslint的预编译器)保存检查时代码,--------@vue/cli-plugin-eslint被安装后生效

2.有效的值:`ture` | `false` | `"error"`  分别会警告和报错

3.让代码检查显示在浏览器上,使用 lintOnSave: 'default' ,会强制eslint-loader将代码检查编译为错误

4.若是个真实的值时eslint-loader 在开发和生产构建下都会被启用。如果你想要在生产构建时禁用 eslint-loader,你可以用如下配置:

// vue.config.js module.exports = {   lintOnSave: process.env.NODE_ENV !== 'production' }

configureWebpack#

  • Type: Object | Function

值为:对象,则通过 webpack-merge 合并到最终的配置中。

值为:函数,则会接收被解析的配置作为参数

更多细节可查阅:配合 webpack > 简单的配置方式

chainWebpack#

  • Type: Function

  • 是一个函数,会接收一个基于 webpack-chain 的 ChainableConfig 实例。允许对内部的 webpack 配置进行更细粒度的修改。

    更多细节可查阅:配合 webpack > 链式操作

devServer#

  • Type: Object

说明:如果你的前端应用和后端 API 服务器没有运行在同一个主机上, 你需要在开发环境下将 API 请求代理到 API 服务器。 这个问题可以通过 vue.config.js 中的 devServer.proxy 选项来配置代理服务器。

1.proxy会拦截所有url中可以成功匹配到 ‘/api’ 的请求

2.它会把拦截到的请求中的baseUrl替换为此处的target

  devServer: {     open: process.platform === 'darwin',// 编译完成是否打开网页     host: '0.0.0.0',// 指定使用地址,默认localhost,0.0.0.0代表可以被外界访问     port: 8080,// 访问端口     https: false,// 编译失败时刷新页面     hotOnly: false,// 开启热加载     proxy: {           '/api': {//拦截器(拦截链接中有/api)                 target: 'http://localhost:8880', //目标地址 请求的后台接口                 changeOrigin: true,                 secure: false,                 // ws: true,                 pathRewrite: {                     '^/api': '/static/mock'                        // 请求数据路径别名,这里是注意将static/mock放入public文件夹                 }           }    },

广告一刻

为您即时展示最新活动产品广告消息,让您随时掌握产品活动新动态!