Vue-cli 搭建 SPA 项目，Vue 项目结构说明，开发示例，以及如何修改端口号，install 命令中的 -g，-S，-D 参数，嵌套路由，package.json 详解
目录
1. vue-cli安装
1.1 安装前提
1.2 什么是vue-cli
1.3 安装vue-cli
2. 使用vue-cli构建项目
2.1 使用脚手架创建项目骨架
2.2 到新建项目目录，安装需要的模块
2.3 如何修改端口号
2.4 添加element-ui模块
2.5 package.json详解
3. install命令中的-g, -S, -D参数
4. vue项目结构说明
5.什么是*.vue文件
6. 启动过程
7. 开发示例
7.1 做一个自定义组件Welcome
7.2 增加“用户管理”和“关于我们”组件
7.3 嵌套路由
1. vue-cli安装
1.1 安装前提
在安装vue-cli前需要先确定nodejs环境安装好，验证nodejs环境安装：
- node -v
- npm -v
1.2 什么是vue-cli
vue-cli是vue.js的脚手架，用于自动生成vue.js+webpack的项目模板。
创建命令：
vue init webpack xxx- xxx 为自己创建项目的名称
- 必须先安装vue,vue-cli，webpack，node等一些必要的环境
1.3 安装vue-cli
命令：
npm install -g vue-cli安装成功后会在配置的node_global\node_modules目录下会看到vue-cli目录。
在cmd窗口输入如下命令，验证vue安装是否成功，注意：这里的V是大写。如果成功会打印版本号
vue -V2. 使用vue-cli构建项目
2.1 使用脚手架创建项目骨架
在cmd命令窗口，到项目存放目录，运行如下命令：
vue init webpack spa1spa1为项目名，根据实现输入即可。
注1：cmd命令行窗口显示中文乱码，多是因为cmd命令行窗口字符编码不匹配导致, 修改cmd窗口字符编码为UTF-8，命令行中执行：chcp 65001, 切换回中文：chcp 936, 这两条命令只在当前窗口生效，重启后恢复之前的编码。不能管。
接下来，安装程序会进入一问一答的安装模式：
1）Project name：项目名，默认是输入时的那个名称spa1，直接回车
2）Project description：项目描述，直接回车
3）Author：作者，随便填或直接回车
4）Vue build：选择题，一般选第一个
- Runtime + Compiler: recommended for most users //运行加编译，官方推荐
- Runtime-only: about 6KB lighter min+gzip, but templates (or any Vue-specific HTML) are ONLY allowed in .vue files - render functions are required elsewhere//仅运行时
5）Install vue-router：是否需要vue-router，Y选择使用，这样生成好的项目就会有相关的路由配置文件
6）Use ESLint to lint your code：是否用ESLint来限制你的代码错误和风格。N
7）Setup e2e tests with Nightwatch?：是否安装e2e测试 N
8）Should we run npm install for you after the project has been created? (recommended) (Use arrow keys)
> Yes, use NPM (选择该项即可)
> Yes, use Yarn
> No, I will handle that myself
全部选择好回车就进行了生成项目，出现如下内容表示项目创建完成
#Project initialization finished!
#========================
2.2 到新建项目目录，安装需要的模块
此步骤类似于maven通过pom文件安装依赖。
命令：
npm install
需要些流量，请使用速度较好的网络。
安装完成后，在命令窗口，到项目目录，运行如下命令：
npm run dev运行项目， 出现：Your application is running here: http://localhost:8080，表示运行成功，在浏览器地址栏输入http://localhost:8080即可查看。
2.3 如何修改端口号
项目运行时默认使用的是8080端口，如果其他程序也使用该端口则会引发冲突，如果tomcat默认使用的也是8080,为避免冲突需要改变端口号。
打开项目目录下config/index.js文件，修改dev部分的port即可
2.4 添加element-ui模块
添加element-ui时先停掉服务，使用如下命令安装element-ui模块。
npm install element-ui -S注1：使用vue+elementUI创建SPA项目，一般情况下其项目结构组成如下：
* Vue + ESLint + webpack + elementUI + ES6
Vue: 主要框架
* ESLint: 帮助我们检查Javascript编程时的语法错误，这样在一个项目中多人开发，能达到一致的语法
* Webpack: 是一个现代 JavaScript 应用程序的静态模块打包器(module bundler)。整个项目中核心配置
* elementUI: 是基于vue的一套样式框架，里面有很多封装好的组件样式
* ES6: 全称ECMAScript6.0，是JavaScript的下一个版本标准，2015.06发版
2.5 package.json详解
每个项目的根目录下面，一般都有一个package.json文件，定义了这个项目所需要的各种模块，以及项目的配置信息（比如名称、版本、许可证等元数据）。npm install命令根据这个配置文件，自动下载所需的模块，也就是配置项目所需的运行和开发环境。
详情见资料“package-详解.json”中的相关注释
3. install命令中的-g, -S, -D参数
| 命令 | 含义 |
|---|---|
| npm install | 下载“package.json”中dependencies和devdependencies中配置的所有依赖模块，并保存到项目的node_modules目录 |
| npm install xxx -g | 全局安装，下载依赖模块，并保存到%node_home%\node_global\node_modules目录下 |
| npm install xxx -S | 写入到package.json的dependencies对象，并保存到项目的node_modules目录 |
| npm install xxx -D | 写入到package.json的devDependencies对象，并保存到项目的node_modules目录 |
注1：在git clone项目的时候，项目文件中并没有node_modules文件夹，为什么呢？
我们知道这个文件中(project_home\node_modules)保存的是我们项目开发中所使用的依赖模块。这个文件夹可能有几百兆大小，如果放到github上，其它人clone的时候会非常慢，这个时候就想到用一个package.json依赖配置文件解决这个问题。这样每个人下载这个项目的时候，只需要进入该项目目录直接npm install npm就会到里面去找需要的函数库，也就是依赖。
缩写命令的全称，注意大小写、-S,-D都是大写
| 命令 | 简称 |
|---|---|
| install | i |
| --save | -S |
| --save-dev | -D |
| --global | -g |
4. vue项目结构说明
| 文件夹 | 文件 | 作用 |
|---|---|---|
| build | 这个文件夹主要是进行webpack的一些配置 | |
| webpack.base.conf.js | webpack基础配置,开发环境,生产环境都依赖 | |
| webpack.dev.conf.js | webpack开发环境配置 | |
| webpack.prod.conf.js | webpack生产环境配置 | |
| build.js | 生产环境构建脚本 | |
| vue-loader.conf.js | 此文件是处理.vue文件的配置文件 | |
| config文件夹 | 配置文件 | |
| dev.env.js | 配置开发环境 | |
| prod.env.js | 配置生产环境 | |
| index.js | 这个文件进行配置代理服务器，例如：端口号的修改 | |
| node_modules | 存放npm install时根据package.json配置生成的npm安装包的文件夹 | |
| src文件夹 | 源码目录(开发中用得最多的文件夹) | |
| assets | 共用的样式、图片 | |
| components | 业务代码存放的地方，里面分成一个个组件存放，一个页面是一个组件，一个页面里面还会包着很多组件 | |
| router | 设置路由 | |
| App.vue | vue文件入口界面 | |
| main.js | 对应App.vue创建vue实例，也是入口文件，对应webpack.base.config.js里的入口配置 | |
| static文件夹 | 存放的文件不会经过webpack处理，可以直接引用，例如swf文件如果要引用可以在webpack配置，对swf后缀名的文件处理的loader，也可以直接将swf文件放在这个文件夹引用 | |
| package.json | 这个文件有两部分是有用的：scripts 里面设置命令以及在dependencies和devDependencies中，分别对应全局下载和局部下载的依赖包 |
5.什么是*.vue文件
*.vue 文件，是一个自定义的文件类型，用类似HTML的语法描述一个Vue组件。每个.vue文件包含三种类型的顶级语言块 ,
流程示意图： 1） 在执行npm run dev的时， 会在当前目录中寻找 package.json 文件, 有点类似 Maven 的 pom.xml 文件，包含项目的名称版本、项目依赖等相关信息。 4） config目录下的index.js文件中包含了host和port等启动服务必须的配置信息，默认端口号可以在这个配置文件中修改。在该文件中如下配置： 配置中的index.html就是项目根目录下的index.html文件。 1） 在components下创建一个Welcome.vue自定义组件 2） 在router/index.js中配置路由，配置路由时要注意先导入组件 我们将默认显示的HelloWorld，修改为了Welcome组件。运行系统观察页面展示。 在src下新增新增一个views目录，用于存放业务组件，components用来方法公用组件。 1）定义About组件 2）定义UserMsg组件 3）在router/index.js中定义路由，配置路由时要注意先导入组件 4）在Welcome组件中加入router-link，配置路由路径，修改后的内容如下：
在用户管理模块下，创建用户注册，修改密码，以此演示嵌套路由 1） 创建用户注册 2）密码修改 3）配置路由 配置路由： 4）在用户管理组件中（UserMsg）加入router-link，配置路由路径，增加后的组件如下：
6. 启动过程
2） 从package.json文件中可以看到，启动npm run dev命令后，会加载build/webpack.dev.conf.js 配置并启动 webpack-dev-server
3） webpack.dev.conf.js 中引入了很多模块的内容，其中就包括 config 目录下服务器环境的配置文件。const config = require('../config')index: path.resolve(__dirname, '../dist/index.html'),
5） index.html 的内容很简单，主要是提供一个 div 给 vue 挂载。
6） main.js中，引入了vue，App和router模块，创建一个vue实例，并把App.vue模块的内容挂载到index.html的id为app的div标签下，并绑定了一个路由配置。
7） main.js把App.vue模块的内容，放置在index.html的div标签下，查看App.vue的内容，这个页面的内容有一个logo和一个
8） router目录下的index.js文件是配置路由的地方。从配置中看到在访问路径"/"的时候，会将HelloWorld模板的内容放置到上面提到的
9） HelloWorld中主要是一些vue的介绍信息。
10） 页面的组成关系：index.html --(包含)--> App.vue --(包含)--> HelloWorld.vue7. 开发示例
7.1 做一个自定义组件Welcome
{{ msg }}
import Welcome from '@/components/Welcome'
export default new Router({
routes: [
{
path: '/HelloWorld',
name: 'HelloWorld',
component: HelloWorld
},
{
path: '/',
name: 'Welcome',
component: Welcome
}
]
})7.2 增加“用户管理”和“关于我们”组件
关于我们
用户管理
import About from '@/views/About'
import UserMsg from '@/views/UserMsg'
....
{
path: '/About',
name: 'About',
component: About
},
{
path: '/UserMsg',
name: 'UserMsg',
component: UserMsg
}
{{ msg }}
7.3 嵌套路由
用户注册
修改密码
配置路由前，先导入组件import UserRegister from '@/views/UserRegister'
import UserPwdUpdate from '@/views/UserPwdUpdate' //此处只显示了用户管理部分路由配置，为嵌套路由
{
path: '/UserMsg',
name: 'UserMsg',
component: UserMsg,
//注意children单词不要写错，如果写错程序不会报错，但效果出不来!!!!
//以"/" 开头的嵌套路径会被当作根路径，所以子路由的path不需要添加 "/" !!
children: [
{
path: 'UserRegister',
name: 'UserRegister',
component: UserRegister
},
{
path: 'UserPwdUpdate',
name: 'UserPwdUpdate',
component: UserPwdUpdate
}
]
}
用户管理