404 Archives Link About
TONG-H
vue cli 3.0初体验
2.1k8WEBvue2018-09-20

尤雨溪：Vue 3.0 计划 原文需翻墙
尤雨溪：Vue 3.0 计划 掘金译文

关于安装

Vue CLI 的包名称由 vue-cli 改成了 @vue/cli

1
2
3
4
npm install -g @vue/cli

安装完成后查看版本
vue --V

项目创建

关于项目创建，除了命令创建3.x还增加了图形化界面创建以及管理vue项目
在创建新项目时还可以混合选用多种集成

  • TypeScript

  • PWA

  • Vue Router & Vuex

  • ESLint / TSLint / Prettier

  • 用 Jest 或 Mocha 进行单元测试

  • 用 Cypress 或者 Nightwatch 进行 E2E 测试

    使用命令创建

    命令：vue create vueapp

1、使用上下箭头选择默认设置还是手动选择功能

1
2
3
4
Vue CLI v3.0.3
? Please pick a preset:
  default (babel, eslint)
> Manually select features

2、按空格键选择你需要的功能，选完后按回车

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
babel：javascript转译器，将最新版的js语法（es6、es7）转换为现阶段浏览器可以兼容的js代码
typescript：使用 TypeScript 书写源码
PWA：渐进式WEB应用
Router：使用vue-router
Vuex：使用vuex
CSS Pre-processors：css预处理器
Linter / Formatter：代码规范标准
Unit Testing：单元测试
E2E Testing：e2e测试
Vue CLI v3.0.3
? Please pick a preset: Manually select features
? Check the features needed for your project:
 (*) Babel
 ( ) TypeScript
 ( ) Progressive Web App (PWA) Support
 (*) Router
 (*) Vuex
>(*) CSS Pre-processors
 (*) Linter / Formatter
 ( ) Unit Testing
 ( ) E2E Testing

3、router是否使用history模式，history需要服务器支持详，情请看这儿https://router.vuejs.org/zh/guide/essentials/history-mode.html
这里我就选no

4、css预处理器的选择，我习惯用sass

5、代码格式化检测选择，我用的是ide是vscode个人感觉搭配插件用着很舒服，所以我选Prettier

6、是否保存刚才的配置，下一次就不用重新配置了，我就直接回车

7、关于Babel, PostCSS, ESLint, etc.这些配置文件你是想放在package.json里面还是单独放在外面
编辑器一般默认会在项目根目录下寻找配置文件，这里我就直接回车选择In dedicated config files

8、是否保存为未来项目的预配置吗，我也是直接回车

最后配置如下

1
2
3
4
5
6
7
8
9
Vue CLI v3.0.3
? Please pick a preset: Manually select features
? Check the features needed for your project: Babel, Router, Vuex, CSS Pre-processors, Linter
? Use history mode for router? (Requires proper server setup for index fallback in production) No
? Pick a CSS pre-processor (PostCSS, Autoprefixer and CSS Modules are supported by default): Sass/SCSS
? Pick a linter / formatter config: Prettier
? Pick additional lint features: Lint on save
? Where do you prefer placing config for Babel, PostCSS, ESLint, etc.? In dedicated config files
? Save this as a preset for future projects? Yes

图形化界面

图形化操作非常方便，我就不一步步演示了，主要懒得贴图 (°ー°〃)

1
2
3
执行npm命令
vue ui
访问 http://localhost:8000 你就可以创建，管理，导入项目

实用新功能

  • node_modules
  • public
  • src
  • .browserslistrc
  • .eslintrc.js
  • .gitignore
  • babel.config.js
  • package.json
  • postcss.config.js
  • README.md

以上是项目根目录，3.x对比2.x文件结构明显精简了不少，多了一个public文件夹用于存放静态文件少了config、build等一系列的配置文件，这些配置文件都被放在了node_modules@vue文件下

browserslist

根目录中多了一个.browserslist文件，可以指定项目的目标浏览器的范围
用于转译的 JavaScript 特性和添加CSS 浏览器前缀，可以减少兼容代码提高代码质量
如果想少一个文件，你也可以在package.json中添加browserslist字段，参数是一个数组

1
2
3
4
这是默认设置，兼容所有最新版本，不支持ie8以下
> 1%
last 2 versions
not ie <= 8

使用 npx browserslist 可以查看项目的浏览器兼容情况
将需要支持的目标浏览器参数放在文件中就好

参数 说明
> 1% 全球超过1%人使用的浏览器
> 5% in US 使用美国使用情况统计，接受两个字母的国家/地区代码
> 5% in my stats 使用自定义使用数据
last 2 versions 所有浏览器兼容到最后两个版本根据CanIUse.com追踪的版本
Firefox ESR 火狐最新版本
Firefox > 20 指定版本范围
not ie <=8 方向排除部分版本
Firefox 12.1 指定浏览器版本
since 2013 2013年之后发布的所有版本

更多请查看官方文档

vue-cli服务

在一个 Vue CLI 项目中，@vue/cli-service 安装了一个名为 vue-cli-service 的命令。
你可以在 npm scripts 中以 vue-cli-service、或者从终端中以 ./node_modules/.bin/vue-cli-service 访问这个命令
Vue CLI 项目有三个模式： development 模式用于启动，production 模式用于打包和e2e测试，test 模式用于unit测试

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
启动
serve:vue-cli-service serve

  --open    在服务器启动时打开浏览器

  --copy    在服务器启动时将 URL 复制到剪切版

  --mode    指定环境模式 (默认值：development)

  --host    指定 host (默认值：0.0.0.0)

  --port    指定 port (默认值：8080)

  --https   使用 https (默认值：false)

打包
build:vue-cli-service build

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

  --target 允许你将项目中的任何组件以一个库或 Web Components 组件的方式进行构建。更多细节请查阅构建目标。

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

测试
   test: vue-cli-service test:e2e  端到端测试
         vue-cli-service test:unit  单元测试

现代模式

为了兼容那些不支持js新特性的浏览器我们需要Babel转译，但转译后的代码笨重冗长，这次3.x提供了一个现代模式

1
npx vue-cli-service build --modern

这个命令会产生两个应用的版本：一个现代版的包，面向支持 ES modules 的现代浏览器，另一个旧版的包，面向不支持的旧浏览器
而且不需要我们手动去部署和设置什么，简直很贴心

  • 现代版的包会通过 <script type="module"> 在被支持的浏览器中加载；它们还会使用 <link rel="modulepreload"> 进行预加载
  • 旧版的包会通过 <script nomodule> 加载，并会被支持 ES modules 的浏览器忽略
  • 一个针对 Safari 10 中 <script nomodule> 的修复会被自动注入

    插件的添加

    在一个已经被创建好的项目中安装一个插件,使用vue add命令

    CLI 插件安装

    每个 CLI 插件都会包含一个 (用来创建文件的) 生成器和一个 (用来调整 webpack 核心配置和注入命令的) 运行时插件
    对于这种cli插件需要加入@vue的前缀，这个命令将 @vue/eslint 解析为完整的包名 @vue/cli-plugin-eslint，然后从 npm 安装它，调用它的生成器
    1
    2
    3
    4
    5
    插件添加
    vue add @vue/eslint

    向被安装的插件传递生成器选项 (这样做会跳过命令提示)
    vue add @vue/eslint --config airbnb --lintOn save

    第三方插件安装

    1
    2
    3
    4
    5
    6
    安装并调用 vue-cli-plugin-apollo，不带 @vue 前缀，该命令会换作解析一个 unscoped 的包
    执行此命令后src里会创建一个plugins文件夹，里面会自动生成关于插件的配置文件
    vue add axios

    基于一个指定的 scope 使用第三方插件，如果一个插件名为 @foo/vue-cli-plugin-bar，你可以这样添加它：
    vue add @foo/bar

    配置修改

    例：向所有 Sass 样式传入共享的全局变量
    在根目录新建一个vue.config.js，加入以下配置
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    module.exports = {
      css: {
        loaderOptions: {
          // 给 sass-loader 传递选项
          sass: {
            // @/ 是 src/ 的别名
            // 所以这里假设你有 `src/variables.scss` 这个文件
            data: `@import "@/variables.scss";`
          }
        }
      }
    }

    打包后路径问题

    在vue.config.js文件种加入’baseUrl: ‘./‘’
    1
    2
    3
    4
    5
    module.exports = {
        //...
        baseUrl: './'
        //...
    }
    虽然官方说这个文件会被 @vue/cli-service 自动加载，但如果你启动项目用的是npm run serve，那么你最好使用npx vue-cli-service serve重启一下

参考文章

官方文档 https://cli.vuejs.org/zh/guide/
browserslist的github https://github.com/browserslist/browserslist
https://mp.weixin.qq.com/s/hfr2Q3FXZFIdqM_r8HrLwQ

欢迎留言交流  (´▽`ʃ♡ƪ)

Copyright © 2017 - 2023蜀ICP备19024124号

本站总访问量 本站访客数