Vue-cli（vue脚手架）超详细教程

前言

“脚手架”，可以方便我们快速的创建项目，自动化地为我们搭建一个项目框架。之前的一篇文章：“Vue.js 快速入门”中提到了 Vue-cli脚手架，那么这篇文章就来介绍一下~

1. 什么是Vue-cli

• Vue cli是基于Vue的应用开发提供的一个标准的脚手架工具.为应用搭建基础的框架结构,提供插件、开发服务、Preset、构建打包功能
• Vue cli 背后集成了现代化开发的诸多功能，通过简单的命令就可以完成 "零配置"的项目环境搭建

2. 安装Vue-cli步骤

在安装vue-cli前，要确认自己的电脑是否安装了nodejs和npm.

2.1 安装Node.js

安装了node.js才有使用npm ，才能安装vue-cli

2.1.1 什么是node.js

从百度百科可以看到，node.js相当于 js 的 tomacat.

为什么会有node.js？

传统意义上的 JavaScript 运行在浏览器上，Chrome 使用的 JavaScript 引擎是 V8，Node.js 是一个运行在服务端 的框架，它的底层就使用了 V8 引擎，这样就可以使用javascript去编写一些服务端的程序，这样也就实现了用 javaScript去开发 Apache + PHP 以及 Java Servlet所开发的服务端功能，这样做的好处就是前端和后端都采用 javascript，即开发一份js程序即可以运行在前端也可以运行的服务端，这样比一个应用使用多种语言在开发效率上 要高，不过node.js属于新兴产品，一些公司也在尝试使用node.js完成一些业务领域，node.js基于V8引擎，基于 事件驱动机制，在特定领域性能出色，比如用node.js实现消息推送、状态监控等的业务功能非常合适。

2.1.2 安装node.js

1. 下载对应你系统的Node.js版本:
   https://nodejs.org/en/download/
   我们统一安装: node-v12.18.1-x64.msi
   
2. 选安装目录进行安装, 我选择安装在了E盘: E:\Program Files\nodejs
3. 测试: 在命令提示符下输入命令

node -v //会显示当前node的版本

2.2 安装NPM

npm全称Node Package Manager，他是node包管理和分发的工具，使用NPM可以对应用的依赖进行管理，NPM
的功能和服务端项目构建工具maven的依赖管理功能差不多，我们通过npm 可以很方便地下载js库，打包js文件。

2.2.1 自动安装NPM

node.js已经集成了npm工具
在命令提示符输入 npm -v 可查看当前npm版本

npm -v

2.2.2 查看包管理路径

包路径就是npm从远程下载的js包所存放的路径。 使用 npm config ls 查询NPM管理包路径（NPM下载的依赖包所存放的路径）

npm config ls

我们发现NPM默认的管理包路径在:

C:\Users\86187\AppData\Roaming\npm

2.2.3 设置包管理路径

依赖包放在C盘不太合适,为了方便对依赖包管理, 我们将管理包的路径设置在单独的地方:

1. 我们选择一个路径,专门存放这些依赖包.我选择创建一个目录: H:\software\nodejs_package
2. 在 H:\software\nodejs_package 下再创建npm_modules 文件夹 和 npm_cache 文件夹:
   
3. 执行下边的命令,设置为自定义的包管理路径：

npm config set prefix "H:\software\nodejs_package\npm_modules"
npm config set cache "H:\software\nodejs_package\npm_cache"

4. 此时再使用 npm config ls 查询NPM管理包路径发现路径已更改
   

2.2.4 NPM环境变量配置

1. 查看npm的全局路径是什么

npm config get prefix

2. 配置PATH环境变量
   

2.2.5 安装cnpm

npm默认会去国外的镜像去下载js包，在开发中通常我们使用国内镜像，这里我们使用淘宝镜像下边我们来安装cnpm：
有时我们使用npm下载资源会很慢，所以我们可以安装一个cnmp(淘宝镜像)来加快下载速度。

1. 联网情况下, 输入命令，进行全局安装淘宝镜像:

//安装
npm install -g cnpm --registry=https://registry.npm.taobao.org
//查看cnpm的版本
cnpm -v

2.3 安装vue-cli

目前主流版本是 2.x 和 3.x 版本,安装3.x 以上的版本是因为该版本既可以创建2.x项目与3.x 项目

注意: 以管理员身份打开命令行

1. 安装命令

npm install -g @vue/cli

2. 输入 vue命令
   
3. 输入 vue -V 查看版本

vue -V

3. 快速构建Vue项目

3.1步骤说明

我们使用vue-cli 快速构建项目,步骤如下:

1. 桌面创建一个空的文件夹
   
2. 以管理员身份运行cmd , 进入到vueTest文件夹
   
3. 执行下面的命令

1.基于交互式命令方式,创建项目
//文件名 不支持驼峰（含大写字母）使用短横线方式
vue create my-project

4. 选择自定义安装,点击回车
   
5. 在这列表中,选择我们要安装的组件,使用空格键选择,选好后回车
   
6. 按回车之后,提示选择什么模式的路由,我们输入 n (表示选择hash模式)
   
7. 选择项目配置文件单独存放
   
8. 是否保存模板,选择n 不创建
   
9. 安装完成,提示输入执行下面这两个命令
   
10. 首先进入项目目录

cd my-project

11. 启动项目

npm run serve

12. 访问项目: http://localhost:8080/

13. 停止项目 只要关闭命令行窗口就可以

3.2 导入Vue项目到VSCode

1. VSCode中右键选择打开文件夹
2. 选择桌面上的项目
3. 打开项目,可以看到如下项目结构
   

3.3 项目结构介绍

3.4 Vue脚手架自定义配置

3.4.1 package.js 介绍

每个项目的根目录下面，一般都有一个 package.json 文件，定义了这个项目所需要的各种模块，以及项目的配置信息（比如名称、版本、许可证等元数据）。npm install 命令根据这个配置文件，自动下载所需的模块，也就是配置项目所需的运行和开发环境。

{
//1.项目基本信息
"name": "project3",
"version": "0.1.0",
"private": true,
//2.指定运行脚本命令
"scripts": {
"serve": "vue-cli-service serve",
"build": "vue-cli-service build"
},
//4.生产环境所依赖模块的版本
"dependencies": {
"core-js": "^3.6.5",
"vue": "^2.6.11",
"vue-router": "^3.2.0"
},
//5.本地环境开发所依赖的版本
"devDependencies": {
"@vue/cli-plugin-babel": "~4.4.0",
"@vue/cli-plugin-router": "~4.4.0",
"@vue/cli-service": "~4.4.0",
"vue-template-compiler": "^2.6.11"
}
}

3.4.2 通过package.json 配置项目

配置内容采用JSON格式,所有的内容都用双引号包裹
打开package.json,再最末端添加如下配置:

"vue":{
"devServer":{
"port":"8888",
"open":true
}
}

• 配置说明: 该配置设置打包时服务器相关的信息
  port : 访问端口
  open true: 打包完成自动打开浏览器

启动项目

1. 在VSCode中选择项目,右键在终端打开
   
2. 输入命令

npm rum serve

3. 运行后发现端口号改为 8888,并且在打包完成后自动打开浏览器
   
   注意: 不推荐这种方式,因为package.json 主要是用来管理包的配置信息.为了方便维护,我们将Vue脚手架相关的配置单独定义到 vue.config.js 配置文件中

3.4.3 单独的配置文件配置项目

1. 在项目的根目录创建文件 vue.config.js
2. 删除掉package中新添加的配置项.
3. 在vue.config.js 文件中进行相关配置

module.exports = {
	devServer:{
	open:true
	port:8889
}
}

由于篇幅原因，就暂时介绍到这里了。通过Vue-cli怎么创建项目，应该已经够用了。这里延申的话，还可以说下Vue 组件化开发、项目运行流程、组件的使用案例等。