注意:
vue-cli3 脚手架搭建完成后,项目目录中没有 vue.config.js 文件,需要手动创建
第一步:手动创建vue.config.js文件,
一般放在和package.json同级目录中,vue.config.js 是一个可选的配置文件,如果项目的 (和 package.json
同级的) 根目录中存在这个文件,那么它会被 @vue/cli-service 自动加载。你也可以使用 package.json 中的 vue
字段,但是注意这种写法需要你严格遵照 JSON 的格式来写。
结构和配置选项如下:
//1.该文件应该导出一个包含了选项的对象:
module.exports={
//这个值也可以被设置为空字符串 ('') 或是相对路径 ('./'),这样所有的资源都会被链接为相对路径,这样打出来的包可以被部署在任意路径。
//默认值是:"/"
publicPath:"./",
//把开发服务器架设在根路径,可以使用一个条件式的值:
publicPath:process.env.NODE_ENV==='production'?'/production-sub-path/':"/",
//举个实例使用方式:
publicPath:process.env.NODE_ENV==='production'?'192.168.60.110:8080':'192.168.60.112:8080',
//输出文件目录,
//当运行 vue-cli-service build 时生成的生产环境构建文件的目录。注意目标目录在构建之前会被清除 (构建时传入 --no-clean 可关闭该行为)。
//默认值是dist
outputDir:"dist",
//放置生成的静态资源 (js、css、img、fonts) 的目录。注意:从生成的资源覆写 filename 或 chunkFilename 时,assetsDir 会被忽略。
//默认值是空""
assetsDir:"static",
//指定生成的 index.html 的输出路径 (相对于 outputDir)。也可以是一个绝对路径。
//默认值是index.html
indexPath:"index.html",
}
构建多页面配置如下:
module.exports={
//默认情况下,生成的静态资源在它们的文件名中包含了 hash 以便更好的控制缓存。然而,这也要求 index 的 HTML 是被 Vue CLI 自动生成的。如果你无法使用 Vue CLI 生成的 index HTML,你可以通过将这个选项设为 false 来关闭文件名哈希。
//默认值是true
filenameHashing:false,
//在 multi-page(多页)模式下构建应用。每个“page”应该有一个对应的 JavaScript 入口文件。
//其值应该是一个对象,对象的 key 是入口的名字,value 是:
//一个指定了 entry, template, filename, title 和 chunks 的对象 (除了 entry 之外都是可选的);或一个指定其 entry 的字符串。
//pages用于多页配置,默认时undefined
//注:当在 多页应用 模式下构建时,webpack 配置会包含不一样的插件 (这时会存在多个 html-webpack-plugin 和 preload-webpack-plugin 的实例)。如果你试图修改这些插件的选项,请确认运行 vue inspect。
//默认值是undefined
pages:{
index:{
//page的入口文件
entry:"src/index/main.js",
//模板文件来源
template:"public/index.html",
//在dist/index.html的输出文件
filename:"index.html",
//当使用页面的title选项时,
//template中的title标签需要是<%= htmlWebpackPlugin.options.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',
//是否在保存的时候使用 `eslint-loader` 进行检查。 有效的值:`ture` | `false` | `"error"` 当设置为 `"error"` 时,检查出的错误会触发编译失败。
//默认值是true
lintOnSave:true,
//是否使用包含运行时编译器的 Vue 构建版本。设置为 true 后你就可以在 Vue 组件中使用 template 选项了,但是这会让你的应用额外增加 10kb 左右。
//默认值是false
runtimeCompiler:false,
//默认情况下 babel-loader 会忽略所有 node_modules 中的文件。如果你想要通过 Babel 显式转译一个依赖,可以在这个选项中列出来。
//默认值是空数组[]
transpileDependencies:"",
//如果你不需要生产环境的 source map,可以将其设置为 false 以加速生产环境构建。
//默认值:true
productionSourceMap:false,
//设置生成的 HTML 中 <link rel="stylesheet"> 和 <script> 标签的 crossorigin 属性
//默认值是:undefined
crossorigin:"",
//在生成的 HTML 中的 <link rel="stylesheet"> 和 <script> 标签上启用 Subresource Integrity (SRI)。如果你构建后的文件是部署在 CDN 上的,启用该选项可以提供额外的安全性。
//默认值是:false
integrity:false
}
}
涉及到webpack相关配置
module.exports={
//如果这个值是一个对象,则会通过 webpack-merge 合并到最终的配置中。
//如果这个值是一个函数,则会接收被解析的配置作为参数。该函数及可以修改配置并不返回任何东西,也可以返回一个被克隆或合并过的配置版本。
//默认值是对象或方法Object|Function
configureWebpack:{}
//链式操作
//Vue CLI 内部的 webpack 配置是通过 webpack-chain 维护的。这个库提供了一个 webpack 原始配置的上层抽象,使其可以定义具名的 loader 规则和具名插件,并有机会在后期进入这些规则并对它们的选项进行修改。
//是一个函数,会接收一个基于 webpack-chain 的 ChainableConfig 实例。允许对内部的 webpack 配置进行更细粒度的修改。
//默认值是一个function
//实例1:修改Loader选项
chainWebpack:config=>{
config.module
.rule('vue')
.use('vue-loader')
.tap(options=>{
//修改它的选项
return options
})
},
//实例2:添加一个新的Loader
chainWebpack:config=>{
//GraphQL Loader
config.module
.rule('graphql')
.test(/\.graphql$)
.use('graphql-tag/loader')
.loader('graphql-tag/loader')
.end()
//你还可以再添加一个loader
.use('other-loader')
.loader('other-loader')
.end()
}
}
css相关配置:
module.exports={
css:{
//将组件内的CSS提取到一个单独的css文件(只用在生产环境中)
//也可以是一个传递给"extract-text-webpack-plugin"的选项对象是否将组件中的 CSS 提取至一个独立的 CSS 文件中 (而不是动态注入到 JavaScript 中的 inline 代码)。
//默认值生产环境下是 true,开发环境下是 false
extract:true,
//是否开启CSS source map
//是否为 CSS 开启 source map。设置为 true 之后可能会影响构建的性能。
//默认值是false
sourceMap:false,
//为预处理器的loader传递自定义选项,比如传递给
//Css-loader时,使用`{Css:{...}}`
//向 CSS 相关的 loader 传递选项。
//支持的 loader 有:css-loader,postcss-loader,sass-loader,less-loader,stylus-loader
//默认值是{}
loaderOptions:{
css:{
//这里的选项会传递给css-loader
},
less:{},
postcss:{
//这里的选项会传递给postcss-loader
}
},
//为所有的CSS及其预处理文件开启CSS Modules
//为这个选项不会影响`*.vue`文件
//默认情况下,只有 *.module.[ext] 结尾的文件才会被视作 CSS Modules 模块。设置为 true 后你就可以去掉文件名中的 .module 并将所有的 *.(css|scss|sass|less|styl(us)?) 文件视为 CSS Modules 模块。
//默认值是false
modules:false
}
}
webpack-dev-server 相关配置,开发环境配置
module.exports={
//所有 webpack-dev-server 的选项都支持。注意:
//有些值像 host、port 和 https 可能会被命令行参数覆写。
//有些值像 publicPath 和 historyApiFallback 不应该被修改,因为它们需要和开发服务器的 publicPath 同步以保障正常的工作。
//默认值是一个空对象{}
devServer:{
open:true,//设置自动打开
port:8080,//设置端口号
open:process.platform==='darwin',
host:'0.0.0.0',
https:false,
hotOnly:false,
//如果你的前端应用和后端 API 服务器没有运行在同一个主机上,你需要在开发环境下将 API 请求代理到 API 服务器。这个问题可以通过 vue.config.js 中的 devServer.proxy 选项来配置。
//配置代理
//默认值是一个字符串或对象string|Object
proxy:{
'/api':{
target:"http://app.restem.com",
changeOrigin:true,
secure:false,如果是http接口,需要配置该参数
pathRewrite:{"^/api":""}
}
'/foo':{
target:'<other_url>'
}
},
before:app=>{}
},
//是否为 Babel 或 TypeScript 使用 thread-loader。该选项在系统的 CPU 有多于一个内核时自动启用,仅作用于生产构建。
//是一个boolean值,默认是require('os').cpus().length > 1,返回一个boolean值
parallel:require('os').cpus().length > 1,
//向 PWA 插件传递选项。类型是一个Object
pwa:{}
//这是一个不进行任何 schema 验证的对象,因此它可以用来传递任何第三方插件选项。类型是一个Object
pluginOptions:{}
}
webpack打包编译
我们可以使用npm run build
进行编译项目,生成文件,生成后的文件才可以上传到服务器上被服务器识别。
如下操作,我们输入npm run build
进行编译。
编译成功后,我们在文件夹目录中会发现多了一个dist
文件夹,里面就是我们编译后的文件,可以直接把这个文件放到服务器中。