vue-cli 构建 vue 项目详解

构建一个 vue 项目最简单的方式就是使用脚手架工具 vue-cli 。前端的三大框架都有本身的脚手架工具，其做用就是用配置好的模板迅速搭建起一个项目工程来，省去本身配置 webpack 配置文件的基本内容，大大下降了初学者构建项目的难度。这节咱们看看如何使用 vue-cli 构建 vue 项目以及对构建项目的具体分析。

1、环境搭建

node 和 npm 是必不可少的，这里再也不介绍。

一、安装 vue-cli

$ npm install -g vue-cli

检查是否安装成功：

$ vue --version
3.3.0

<!-- more -->

二、构建项目

$ vue init webpack hello-vue

初始化的过程当中，会有一个交互式的选项让你选择项目的一些配置，根据项目需求选择便可。为了方便后面几篇教程的演示，能够统一选择如下选项：

? Project name hello-vue # 项目名称
? Project description A Vue.js project # 项目描述
? Author Deepspace <cxin1427@gmail.com> # 做者
? Vue build standalone # 运行+编译时
? Install vue-router? Yes # 安装 vue-router
? Use ESLint to lint your code? Yes # 使用 ESLint 做为代码规范
? Pick an ESLint preset Airbnb # 选择 Airbnb 的代码规范
? Set up unit tests Yes # 安装单元测试
? Pick a test runner karma # 测试模块
? Setup e2e tests with Nightwatch? Yes # 安装 e2e 测试
? Should we run `npm install` for you after the project has been created? (recommended) npm # 包管理器，npm

构建完成以后，会提示构建成功信息：

# Project initialization finished!
# ========================

To get started:

  cd hello-vue
  npm run dev

Documentation can be found at https://vuejs-templates.github.io/webpack

三、启动项目

$ cd hello-vue
$ npm run dev

项目默认会在 8080 端口启动，若是端口有占用，会自动调整端口。打开浏览器输入：http://localhost:8080，会看到构建的项目的主页：

四、目录结构

使用编辑器打开(推荐使用 VSCode)，下面具体看看目录结构：

package.json :

{
    "scripts": {
        "dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",
        "start": "npm run dev",
        "unit": "cross-env BABEL_ENV=test karma start test/unit/karma.conf.js --single-run",
        "e2e": "node test/e2e/runner.js",
        "test": "npm run unit && npm run e2e",
        "lint": "eslint --ext .js,.vue src test/unit test/e2e/specs",
        "build": "node build/build.js"
    }
}

在 package.json 中，根据咱们在构建项目的时候的选项，有如下几个命令。

• npm run dev ：项目开发阶段，项目启动的命令；
• npm run lint ：使用 eslint 检查代码格式；
• npm run test：单元测试和 e2e 测试；
• npm run e2e : e2e 测试；
• npm run build：开发完成后执行，会把咱们的源代码编译成最终的发布代码，生成在项目根目录中的 dist 文件夹下（初始化项目时不会生成）。

config： 保存一些项目初始化配置。

build ：里面保存一些 webpack 的初始化配置。

index.html : 是咱们的首页。index 不少时候都被预设为首页，像 index.htm，index.php 等。

src : 保存项目源代码的地方，咱们下面会详细分析该文件夹里的文件。

2、代码分析

Vue 的核心架构分为两个部分：路由和组件，其实 React 也是同样的。咱们在切入一个项目的时候，都是从这两个点出发。下面咱们具体看看 src 文件夹。

一、入口文件

若是咱们打开项目根目录下 build 目录中的 webpack.base.conf.js，会看到这样的代码(第22行)：

module.exports = {
  context: path.resolve(__dirname, '../'),
  entry: {
    app: './src/main.js'
  },
  // ...
}

说明咱们的入口文件就是 src 目录下的 main.js 文件。看看代码：

// The Vue build version to load with the `import` command
// (runtime-only or standalone) has been set in webpack.base.conf with an alias.
import Vue from 'vue';
import App from './App';
import router from './router';

Vue.config.productionTip = false;

/* eslint-disable no-new */
new Vue({
  el: '#app',
  router,
  components: { App },
  template: '<App/>',
});

看看这里面作了什么事情：

• 引入 vue 并起名叫做 Vue
• 引入 根目录下的 App.vue 文件(后缀名可不要)
• 引入 router 文件下的 index.js 文件(文件夹后没有具体的文件，默认引入的就是 index.js 文件)

• 经过 new 实例化 Vue 实例 ，实例化的时候声明了几个属性：

  • el：'#app'：意思是将全部视图放在 id 值为 app 这个 dom 元素中，也就是项目根目录下的 index.html 中的那个 div : <div id="app"></div>；
  • components: { App }：意思是将上面引入的 App.vue 文件的内容将以 <App/> 这样的标签写进 <div id="app"></div> 中；

在开始的时候，咱们并无介绍说 Vue 使用的是虚拟 DOM ，那么，从这里咱们看出，Vue 使用的也是虚拟 DOM (和React是同样的)。

这里对 虚拟 DOM 做下简单介绍：当咱们修改应用程序时，不会对 DOM 进行更改，而是建立以 JavaScript 数据结构形式存在的 DOM 副本，而后插到文档当中。不管什么时候进行任何更改，都将对 JavaScript 数据结构进行更改，并将后者与原始数据结构进行比较（ diff算法），而后将最终更改更新为真实 DOM。咱们都知道 DOM 是很是重的，因此 虚拟 DOM 是很是省性能的。

二、App.vue

经过入口文件中作的事情，咱们其实已经知道 App.vue 的做用了：单页面应用的主组件。全部页面都是在 App.vue 下经过路由进行切换的。因此，咱们能够理解为全部的路由（route）也是 App.vue 的子组件。咱们看看代码：

<template>
  <div id="app">
    <img src="./assets/logo.png">
    <router-view/>
  </div>
</template>

<script>
export default {
  name: 'App',
};
</script>

<style>
#app {
  font-family: 'Avenir', Helvetica, Arial, sans-serif;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  text-align: center;
  color: #2c3e50;
  margin-top: 60px;
}
</style>

这里须要提一下： node 之因此能够识别出 *·vue 格式的文件，是由于 webpack 在编译时将 *.vue 文件中的 html 、 js 、 css 都抽出来造成新的单独文件。可经过 npm run build 命令编译源代码，查看 dist 文件下的文件来验证。

App.vue 的内容分为三个部分：<template>...</template>、<script>...</script>、<style>...</style> ，分别在这三类标签里面写入结构、脚本、样式。

咱们先从 <template> 看起：里面一个 div 包裹着 img 标签和 router-view 标签。前面提到过： App.vue 是单页面应用的主组件。对照着前面在浏览器中打开的应用主页面，img 标签就是页面上方的 Vue 的 logo。那下面的内容去哪了呢？和 <router-view/> 有关系吗？这就要去看路由了。

三、router/index.js

import Vue from 'vue';
import Router from 'vue-router';
import HelloWorld from '@/components/HelloWorld';

Vue.use(Router);

export default new Router({
  routes: [
    {
      path: '/',
      name: 'HelloWorld',
      component: HelloWorld,
    },
  ],
});

前面先引入了路由插件 vue-router，而后显式声明要用路由 Vue.use(Router) 。路由的配置很是地明了：给不一样 path 分配不一样的组件（或者页面），参数 name 只是用来识别。

当我访问根路由 http://localhost:8080/#/ 时，App.vue 中的 <router-view/> 就会把引入的 HelloWorld 组件分配给我，放在了 img 标签的下面，打开 components 目录下的 HelloWorld.vue 就能够看到具体内容了。

咱们在看到浏览器中的 url 的时候会以为奇怪，为何在后面加了一个 # 号呢？这是由于 vue-router 默认 hash 模式 —— 使用 URL 的 hash 来模拟一个完整的 URL，当 URL 改变时，页面不会从新加载。详见： https://router.vuejs.org/zh/g... 。这里可先跳过这点内容。

如今，咱们在浏览器访问 http://localhost:8080/#/vue 这个地址，会发现只出现了 Vue 的 logo。这是由于咱们并无配置 /vue 这个路由，找不到路由，那<router-view/> 这个标签就不会加载出来。

到这里，咱们就知道路由是如何根据 url 来分配不一样的组件了。配置多个路由就很简单了：

export default new Router({
  routes: [
    {
      path: '/',
      name: 'HelloWorld',
      component: HelloWorld
    },
    {
      path: '/about',
      name: 'about',
      component: About
    },
    {
      path: '/vue',
      name: 'vue',
      component: Vue
    }
  ]
})

那若是要访问 http://localhost:8080/#/vue/demo 怎么办呢？

export default new Router({
  routes: [
    {
      path: '/',
      name: 'HelloWorld',
      component: HelloWorld,
    },
    {
      path: '/about',
      name: 'about',
      component: About,
    },
    {
      path: '/vue',
      name: 'vue',
      component: Vue,
      children: [
        {
          path: '/demo',
          component: demo,
        },
        {
          path: '/project',
          component: project,
        },
      ],
    },
  ],
});

给路由加多一个子路由配置便可。

四、assets

用来存放一些图片、样式等静态文件。

3、总结

欢迎关注个人博客： https://togoblog.cn/