一份超级详细的Vue-cli3.0使用教程[赶忙来试试！]

时间 2019-11-05

标签一份超级详细 vue cli3.0 cli 使用教程赶忙试试繁體版

原文原文链接

前言

在vue-cli 2.X的时候，也写过一篇相似的文章，在八月份的时候vue-cli已经更新到了3.X，新版本的脚手架，功能灰常强大，试用事后很是喜欢，写篇教程来帮助各位踩一下坑。css

前端进阶积累、公众号、GitHubhtml

主要内容：

零配置启动/打包一个.vue文件
详细的搭建过程
重点推荐：使用图形化界面建立/管理/运行项目

安装：

卸载旧版本：

若是你事先已经全局安装了旧版本的vue-cli(1.x 或 2.x),你须要先卸载它:前端

npm uninstall vue-cli -g
复制代码

Node版本要求：

3.x须要在Node.js8.9或更高版本(推荐8.11.0+)，点击这里能够安装nodevue

大多数人都安装过了node,使用下面的命令行查询你的node版本:node

node -v
复制代码

若是你的版本不够，可使用下面的命令行来把Node版本更新到最新的稳定版：webpack

npm install -g n // 安装模块 这个模块是专门用来管理node.js版本的
n stable // 更新你的node版本
复制代码

mac下，更新版本的时候,若是提示你权限不够：git

sudo n stable // 我就遇到了
复制代码

安装vue-cli:

npm install -g @vue/cli // 安装cli3.x
vue --version // 查询版本是否为3.x
复制代码

若是cli3.x用的不舒服，cli3也能使用2.x模板：github

npm install -g @vue/cli-init // 安装这个模块
// 就可使用2.x的模板：vue init webpack my-project
复制代码

零配置启动/打包一个`.vue`文件：

安装扩展：

npm install -g @vue/cli-service-global
复制代码

安装完扩展以后，能够随便找个文件夹建一个以下方示例的.vue文件,而后跑起来：web

vue serve App.vue // 启动服务
vue build App.vue // 打包出生产环境的包并用来部署
复制代码

以下图，只需一个.vue文件，就能迅速启动一个服务：

如图所示，服务启动的时候回生成一个node_modules包，稍微测试了一下，服务支持ES6语法和热更新，打包的时候会生成一个dist文件夹。(新建一个test.vue文件也只有一个node_modules/dist文件夹)vue-router

这是个很棒的功能，用于开发一个库、组件，作一些小demo等都是很是适合的！

第一次建立项目:

1. 命令行:

vue create hello-cli3 
复制代码

hello-cli3是文件夹名字，若是不存在会自动建立文件夹，若是存在会安装到那个文件夹中。
相比2.x的时候须要本身手动建立一个文件夹，这里也算是一个小优化吧。

2. 选择模板:

一开始只有两个选项: default(默认配置)和Manually select features(手动配置)

默认配置只有babel和eslint其余的都要本身另外再配置，因此咱们选第二项手动配置。
在每次选择手动配置以后，会询问你是否保存配置，也就是图片中的koro选项，这样之后咱们在进行建立项目的时候只需使用原先的配置就能够了，而不用再进行配置。

3. 选择配置：

根据你的项目须要来选择配置,空格键是选中与取消，A键是全选

? Check the features needed for your project: (Press <space> to select, <a> to toggle all, <i> to invert selection) 
  // 检查项目所需的功能:(按<space>选择，<a>切换全部，<i>反转选择）
  >( ) TypeScript                                 // 支持使用 TypeScript 书写源码
   ( ) Progressive Web App (PWA) Support          // PWA 支持
   ( ) Router                                     // 支持 vue-router
   ( ) Vuex                                       // 支持 vuex
   ( ) CSS Pre-processors                         // 支持 CSS 预处理器。
   ( ) Linter / Formatter                         // 支持代码风格检查和格式化。
   ( ) Unit Testing                               // 支持单元测试。
   ( ) E2E Testing  
复制代码

4. 选择css预处理器:

若是你选择了Css预处理器选项，会让你选择这个

? Pick a CSS pre-processor (PostCSS, Autoprefixer and CSS Modules are supported by default):
  // 选择CSS预处理器（默认支持PostCSS，Autoprefixer和CSS模块）：
  > SCSS/SASS
    LESS
    Stylus
复制代码

5. 是否使用路由的`history`模式：

这里我建议选No，这样打包出来丢到服务器上能够直接使用了，后期要用的话，也能够本身再开起来。

选yes的话须要服务器那边再进行设置。

Use history mode for router? (Requires proper server setup for index fallback in production) 
  // 路由使用history模式?(在生产环境中须要适当的服务器设置以备索引)
复制代码

6. 选择Eslint代码验证规则：

> ESLint with error prevention only
  ESLint + Airbnb config
  ESLint + Standard config
  ESLint + Prettier
复制代码

7. 选择何时进行代码规则检测：

建议选保存就检测，等到commit的时候，问题可能都已经积累不少了。

以前写了篇VsCode保存时自动修复Eslint错误推荐一下。

? Pick additional lint features: (Press <space> to select, <a> to toggle all, <i> to invert selection)
  >( ) Lint on save // 保存就检测
   ( ) Lint and fix on commit // fix和commit时候检查
复制代码

8. 选择e2e测试:

? Pick a E2E testing solution: (Use arrow keys)
❯ Cypress (Chrome only) 
  Nightwatch (Selenium-based) 
复制代码

9. 把babel,postcss,eslint这些配置文件放哪：

一般咱们会选择独立放置，让package.json干净些

? Where do you prefer placing config for Babel, PostCSS, ESLint, etc.? (Use arrow keys)
  > In dedicated config files // 独立文件放置
    In package.json // 放package.json里
复制代码

10. 是否保存配置：

Save this as a preset for future projects? (Y/n) // 是否记录一下以便下次继续使用这套配置
// 选保存以后，会让你写一个配置的名字：
Save preset as:  name // 而后你下次进入配置能够直接使用你此次的配置了
复制代码

11. 下载依赖

12. webpack配置的目录不见了：

一块儿来看一下新项目的结构(下图),会发现2.x的webpack配置的目录不见了，也就是没有build、config这两个文件夹了：

这种方式的优点对小白来讲很是友好，不会一上来就两个文件夹，一堆文件，看着脑壳都大了。
而后在引用抄别人的配置的时候，也很是方便，直接将文件复制过来就行了。
在自定义一下webpack的配置，咱们须要在根目录新建一个vue.config.js文件，文件中应该导出一个对象，而后进行配置，详情查阅官方文档
```
// vue.config.js
  module.exports = {
    // 选项...
  }
复制代码
```
还有一些小变更像：static文件夹改成public了，router文件夹变成了单个文件之类的(我以前一直这么作,嘿嘿)。