vue 快速入门 系列 —— vue-cli 上 (5)

这些额外的配置将会根据 useConfigFiles 的值被合并到 package.json 或相应的配置文件中。例如，当 "useConfigFiles": true 的时候，configs 的值将会被合并到 vue.config.js 中。

你可以显式地指定用到的插件的版本：

{ "plugins": { "@vue/cli-plugin-eslint": { "version": "^3.0.0", // ... 该插件的其它选项 } } }

注意对于官方插件来说这不是必须的——当被忽略时，CLI 会自动使用 registry 中最新的版本。不过推荐为 preset 列出的所有第三方插件提供显式的版本范围。

CLI 服务 使用命令

在一个 Vue CLI 项目中，@vue/cli-service 安装了一个名为 vue-cli-service 的命令。你可以在 npm scripts 中以 vue-cli-service、或者从终端中以 ./node_modules/.bin/vue-cli-service 访问这个命令。

上文我们创建的项目 demo2 的 package.json 中的命令有：

{ "scripts": { "serve": "vue-cli-service serve", "build": "vue-cli-service build", "lint": "vue-cli-service lint" } }

可以通过 npm 或 npx（最新版的 npm 应该已经自带） 执行命令：

> npm run serve > npx vue-cli-service serve

Tip: 可以通过 vue ui 命令使用 GUI 运行更多的特性脚本

vue-cli-service serve 用法：vue-cli-service serve [options] [entry] 选项： --open 在服务器启动时打开浏览器 --copy 在服务器启动时将 URL 复制到剪切版 --mode 指定环境模式 (默认值：development) --host 指定 host (默认值：0.0.0.0) --port 指定 port (默认值：8080) --https 使用 https (默认值：false)

vue-cli-service serve 命令会启动一个开发服务器 (基于 webpack-dev-server) 并附带开箱即用的模块热重载 (Hot-Module-Replacement)。

除了通过命令行参数，你也可以使用 vue.config.js 里的 devServer 字段配置开发服务器

命令行参数 [entry] 将被指定为唯一入口，而非额外的追加入口。尝试使用 [entry] 覆盖 config.pages 中的 entry 将可能引发错误。

// 在服务器启动时打开浏览器 demo2> npx vue-cli-service serve --open // 或者指定 entry demo2> npx vue-cli-service serve --open ./src/main.js

Tip：终端可能因为 eslint 报错而终止编译，可以更改 eslint 配置。在项目根目录下新建 vue.config.js，重启服务即可。

// vue.config.js module.exports = { lintOnSave: true } vue-cli-service build 用法：vue-cli-service build [options] [entry|pattern] 选项： --mode 指定环境模式 (默认值：production) --dest 指定输出目录 (默认值：dist) --modern 面向现代浏览器带自动回退地构建应用 --target app | lib | wc | wc-async (默认值：app) --name 库或 Web Components 模式下的名字 (默认值：package.json 中的 "name" 字段或入口文件名) --no-clean 在构建项目之前不清除目标目录 --report 生成 report.html 以帮助分析包内容 --report-json 生成 report.json 以帮助分析包内容 --watch 监听文件变化

vue-cli-service build 会在 dist/ 目录产生一个可用于生产环境的包，带有 JS/CSS/HTML 的压缩，和为更好的缓存而做的自动的 vendor chunk splitting。它的 chunk manifest 会内联在 HTML 里。

这里还有一些有用的命令参数：

--modern 使用现代模式构建应用，为现代浏览器交付原生支持的 ES2015 代码，并生成一个兼容老浏览器的包用来自动回退。

// 打包生成了两份：现代包和遗留包 demo2> npx vue-cli-service build --modern // 为生产构建遗留包... / Building legacy bundle for production... File Size Gzipped dist\js\chunk-vendors-legacy.7b12297e.js 117.56 KiB 40.92 KiB dist\js\app-legacy.853ea99d.js 5.15 KiB 1.84 KiB dist\css\app.fb0c6e1c.css 0.33 KiB 0.23 KiB // 省略了图像和其他类型的资产 Images and other types of assets omitted. // 为生产构建现代捆绑... - Building modern bundle for production... File Size Gzipped dist\js\chunk-vendors.1e2bb21b.js 92.78 KiB 32.14 KiB dist\js\app.d739a095.js 5.07 KiB 1.81 KiB dist\css\app.fb0c6e1c.css 0.33 KiB 0.23 KiB // 省略了图像和其他类型的资产 Images and other types of assets omitted.

--target 允许你将项目中的任何组件以一个库或 Web Components 组件的方式进行构建。

--report 和 --report-json 会根据构建统计生成报告，它会帮助你分析包中包含的模块们的大小。

demo2> npx vue-cli-service build --report | Building for production... File Size Gzipped dist\js\chunk-vendors.7b12297e.js 117.55 KiB 40.92 KiB dist\js\app.853ea99d.js 5.14 KiB 1.83 KiB dist\css\app.fb0c6e1c.css 0.33 KiB 0.23 KiB Images and other types of assets omitted.

会在 dist 目录中生成 report.html。

Tip: 如果你使用的是 vscode，只需要安装 Live Server 插件，即可右键通过 live server 查看 report.html，非常方便。