1.搭建Vue-Cli脚手架
2.Vue-cli工程目录结构及运行分析
3.Vue-cli工程配置文件
4.使用Vue-cli完成todoList案例
- 4.1.工程目录结构
- 4.2.组件代码
5.Vue-cli的打包部署
- 5.1.Vue-cli工程为什么要打包部署
- 5.2.Vue-cli工程打包配置

1.搭建Vue-Cli脚手架

vue-cli 是一个官方发布 vue.js 项目脚手架，使用 vue-cli 可以快速创建 vue 项目。下面介绍 vue-cli 的整个搭建过程。

注意：以下内容是基于Vue-cli4.0以上版本的。

1.1.安装npm

NPM（node package manager）是随同node.js一起安装的包管理工具，能解决前端代码部署上的很多问题，常见的使用场景有以下几种：

允许用户从NPM服务器下载别人编写的第三方包到本地使用。
允许用户从NPM服务器下载并安装别人编写的命令行程序到本地使用。
允许用户将自己编写的包或命令行程序上传到NPM服务器供别人使用。

实际上，npm就是前端的Maven。
从node官网下载并安装node，安装步骤很简单，只要一路next就可以了。安装完成后，打开命令行工具输入命令node -v，如下图，如果出现对应版本号，就说明安装成功了。

C:\Users\Administrator>node -v
v10.16.0

我们所需要的npm也已经安装好了，输入如下命令，显示出npm的版本信息。

C:\Users\Administrator>npm -v
6.9.0

到这里node的环境已经安装完了,npm包管理工具也有了，但是由于npm的有些资源被墙，为了更快更稳定,所以我们需要切换到淘宝的npm镜像——cnpm。

1.2.安装cnpm

点击进入淘宝的cnpm网站,里面有详细的配置方法。或者直接在命令行输入：

npm install -g cnpm --registry=https://registry.npm.taobao.org

然后等待，安装完成。输入cnpm -v，可以查看当前cnpm版本，这个和npm的版本还是不一样的。

C:\Users\Administrator>cnpm -v
cnpm@6.1.1

使用cnpm的方法就是，需要用到npm的地方直接使用cnpm替换就可以了。

1.3.全局安装 vue-cli

全局安装vuecli（就相当与在本机的npm仓库中有了vuecli）：

//安装最新@vue/cli版本
npm install -g @vue/cli
//安装指定的@vue/cli版本    
npm install -g @vue/cli@4.1.1

安装完成后，使用 vue -V 显示版本号来测试vue是否安装成功。

C:\Users\Administrator>vue -V
@vue/cli 4.1.1

1.4.创建vue-cli工程

在命令行下进入到工作空间文件夹中，输入如下命令：
vue create hello hello是工程名（注意：工程名必须全部小写）
选择预设模板。这里选择“Manually select features”（手动选择特征）
通过 ↑↓ 箭头选择依赖，按 “空格” 选中，按 “a” 全选，按 “i” 反选。
1. Babel：转码器，可以将ES6代码转为ES5代码，可兼容不支持ES6的浏览器。
2. TypeScript：是JavaScript的超集（.ts文件），包含并扩展了 JavaScript 的语法。需要被编译输出为 JavaScript在浏览器运行。
3. Progressive Web App (PWA) Support：渐进式Web应用程序
4. Router ：vue-router（vue路由）
5. Vuex ：vuex（vue的状态管理模式）
6. CSS Pre-processors ：CSS 预处理器（如：less、sass）
7. Linter / Formatter：代码风格检查和格式化（如：ESlint）
8. Unit Testing ：单元测试（unit tests）
9. E2E Testing ：e2e（end to end）测试
  第一次创建工程时，可以只选择Babel和Router即可。
选择是否使用history 形式的路由，也就是询问路径是否带 # 号，这里选择 n。
询问将依赖文件放在独立文件中，还是package.json中：为了保持工程配置文件的整洁性，这里选择“In package.json”。
询问是否将当前选择保存以备下次使用。这里选择“n”。
接下来耐心等待安装：最后出现：

按照提示，进入工程根目录。
输入：npm run serve 启动工程。
启动成功。
在浏览器中测试：http://localhost:8080

2.Vue-cli工程目录结构及运行分析

package.json文件：这里配置了本工程中安装的模块：

"dependencies": {
 "core-js": "^3.6.5",
 "vue": "^2.6.11",
 "vue-router": "^3.2.0"
},

html入口文件：public目录中的index.html文件。在此文件中有一个总容器：

注意：整个工程中只有index.html一个页面，所以，Vue-cli工程就是一个SPA（单页应用）工程。

<div id="app"></div>

javascript入口文件：src目录中的main.js文件。在入口js文件中：
1. 首先导入了vue模块，路由模块和App.vue主vue组件。
2. 然后创建了一个Vue实例。
3. 在此Vue实例中，调用了render（渲染视图函数）函数，此函数返回App.vue主组件。也就是使用App.vue来渲染index.html视图组件。
4. 最后，使用$mount方法，将index.html中的总容器（#app）挂载到Vue实例上。
App.vue主组件：
template标签中书写当前组件html代码。这里调用了公共组件HelloWorld。
script标签中书写当前组件的js代码。这里导入了HelloWorld公共组件成为子组件。
style标签中书写当前组件的css代码。

注意：一个vue文件，就是一个Vue组件
HelloWorld.vue公共组件：
这是vuecli给我们提供的一个示例组件。至此，我们终于知道：为什么运行后浏览器中会显示这样的页面。

最后，在package.json文件中有这样的配置：

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

于是，我们知道了，npm run serve命令，实际上就是运行“vue-cli-service serve”

3.Vue-cli工程配置文件
vuecli3.x以上版本中为了精简配置文件，专门设置了一个可选的配置文件。只要在项目的根目录（与package.json同级）中，添加名称为vue.config.js的文件，就能自动被vue-cli加载。在此文件中可以配置vuecli工程中的一些配置。
```
module.exports = {
 devServer: {
     port: 8088     //修改启动端口
 }
}
```
4.使用Vue-cli完成todoList案例
todoList案例功能介绍：
输入框输入待办事项后点击添加，该事项会出现在todo区域内，输入框内的文字消失
todo区域内的事项为待办事项，点击某一事项后，该事项移入done区域
done区域内的事项为完成事项，点击某一事项后，该事项消失

4.1.工程目录结构

主组件App.vue

共通组件：AddNew.vue、TheList.vue

4.2.组件代码

共通组件 AddNew.vue

<template>
 <div id="add-new">
     <input type="text" v-model="newItem">
     <button @click="handleAdd">添加</button>
 </div>
</template>
<script>
 export default {
     name: 'AddNew',
     data() {
         return {
             newItem: ''
         }
     },
     methods: {
         handleAdd: function() {
             if (this.newItem == '') {
                 alert("不能为空");
                 return;
             }
             this.$emit('submitNewItem', this.newItem);
             this.newItem = '';
         }
     }
 }
</script>
<style scoped>
 input{
     border: none;
     outline: none;
     width: 300px;
     height: 30px;
     border: solid 1px #999;
     border-radius: 5px;
     padding-left: 10px;
 }
 button{
     border: none;
     outline: none;
     width: 80px;
     height: 36px;
     background-color: #42B983;
     border-radius: 5px;
     margin-left: 10px;
     color: #fff;
 }
</style>

共通组件 TheList.vue

<template>
 <ol>
     <li v-for="(item,index) in list" :key="index" @click="judgeItem(index)">{{item}}</li>
 </ol>
</template>
<script>
 export default {
     name: "TheList",
     /*
      * props除了使用字符串数组形式，还可以使用对象形式。
      * 这样就可以对传入的数据进行验证。
      * 包括数据类型验证、必填验证、设置默认值等。
      */
     props: {
         list: {
             type: Array,
             required: true,
         },
         listType: {
             type: Boolean,
             default: false,
         }
     },
     methods: {
         judgeItem: function(index) {
             if (!this.listType) {
                 this.$emit("handleJudge", index);
             } else {
                 this.$emit("handleDelete", index);
             }
         }
     }
 }
</script>
<style scoped>
 ol{
     margin-top: 20px;
 }
 ol li{
     cursor: pointer;
 }
</style>

主组件App.vue

<template>
 <div id="app">
     <h1>todoList</h1>
     <AddNew @submitNewItem="addNewItem"></AddNew>
     <!-- todo 代办区域 -->
     <TheList @handleJudge="toDone" :list="todoList"></TheList>
     <hr>
     <!-- done 完成区域 -->
     <TheList @handleDelete="toDelete" :list="doneList" :listType="true"></TheList>
 </div>
</template>
<script>
 import AddNew from './components/AddNew';
 import TheList from './components/TheList';
 export default {
     name: "app",
     data() {
         return {
             todoList: [],     //代办事项
             doneList: []      //完成事项
         }
     },
     methods: {
         addNewItem: function(newItem) {
             this.todoList.push(newItem);
         },
         toDone: function(index) {
             this.doneList.push(this.todoList.splice(index, 1)[0])
         },
         toDelete: function(index) {
             this.doneList.splice(index, 1);
         }
     },
     components: {
         AddNew,
         TheList
     }
 }
</script>

5.Vue-cli的打包部署

5.1.Vue-cli工程为什么要打包部署

我们所完成的工程，最终都是要部署到服务器（Tomcat、Nginx等等）上运行的。但是，服务器是不可能识别vue文件的，因为vue文件只是Vue-cli工程中的一种自定义文件。
所以，我们需要将vue文件中的html代码、css代码、js代码抽取出来，重新打包成真正的html文件、css、文件和js文件，然后才能部署到服务器上。

5.2.Vue-cli工程打包配置

在vue.config.js文件中添加如下配置：

module.exports = {
 //打包基本目录
 publicPath:'./',
 //输出目录
 outputDir:'dist',
 //静态资源目录
 assetsDir:'assets',
 ... ...
}

在命令行中进入到工程目录，运行如下命令：

npm run build

在工程目录中，就会出现 “dist” 目录，这就是打包好的工程

注意：打包工程必须要放在一个 HTTP 服务器中才能运行。

Java 互联网架构课件（网络）

06.Vue-Cli脚手架