Vue-cli是vue官方出品的快速構(gòu)建單頁應(yīng)用的腳手架

第1節(jié)：Vue-cli，開始吧騷年

安裝vue-cli

安裝vue-cli的前提是你已經(jīng)安裝了npm，安裝npm你可以直接下載node的安裝包進行安裝。你可以在命令行工具里輸入npm -v 檢測你是否安裝了npm和版本情況。出現(xiàn)版本號說明你已經(jīng)安裝了npm和node，我這里的npm版本為3.10.10。如果該命令不可以使用，需要安裝node軟件包，根據(jù)你的系統(tǒng)版本選擇下載安裝就可以了。

下載地址：http://nodejs.cn/download/

alt

npm沒有問題，接下來我們可以用npm 命令安裝vue-cli了，在命令行輸入下面的命令：

//全局安裝vue-cli
npm install vue-cli -g

    -g :代表全局安裝。如果你安裝時報錯，一般是網(wǎng)絡(luò)問題，你可以嘗試用cnpm來進行安裝。安裝完成后，可以用vue
    -V來進行查看 vue-cli的版本號。注意這里的V是大寫的。我這里版本號是2.8.1.

如果vue -V的命令管用了，說明已經(jīng)順利的把vue-cli安裝到我們的計算機里了。

初始化項目

我們用vue init命令來初始化項目，具體看一下這條命令的使用方法。

$ vue init <template-name> <project-name>

init：表示我要用vue-cli來初始化項目

<template-name>：表示模板名稱，vue-cli官方為我們提供了5種模板，

webpack-一個全面的webpack+vue-loader的模板，功能包括熱加載，linting,檢測和CSS擴展。

webpack-simple-一個簡單webpack+vue-loader的模板，不包含其他功能，讓你快速的搭建vue的開發(fā)環(huán)境。

browserify-一個全面的Browserify+vueify 的模板，功能包括熱加載，linting,單元檢測。

browserify-simple-一個簡單Browserify+vueify的模板，不包含其他功能，讓你快速的搭建vue的開發(fā)環(huán)境。

-simple-一個最簡單的單頁應(yīng)用模板。

<project-name>：標(biāo)識項目名稱，這個你可以根據(jù)自己的項目來起名字。 在實際開發(fā)中，一般我們都會使用webpack這個模板，那我們這里也安裝這個模板，在命令行輸入以下命令：

vue init webpack vuecliTest

輸入命令后，會詢問我們幾個簡單的選項，我們根據(jù)自己的需要進行填寫就可以了。

Project name :項目名稱 ，如果不需要更改直接回車就可以了。注意：這里不能使用大寫，所以我把名稱改成了vueclitest
Project description:項目描述，默認(rèn)為A Vue.js project,直接回車，不用編寫。
Author：作者，如果你有配置git的作者，他會讀取。
Install vue-router? 是否安裝vue的路由插件，我們這里需要安裝，所以選擇Y
Use ESLint to lint your code? 是否用ESLint來限制你的代碼錯誤和風(fēng)格。我們這里不需要輸入n，如果你是大型團隊開發(fā)，最好是進行配置。
setup unit tests with Karma + Mocha? 是否需要安裝單元測試工具Karma+Mocha，我們這里不需要，所以輸入n。
Setup e2e tests with Nightwatch?是否安裝e2e來進行用戶行為模擬測試，我們這里不需要，所以輸入n。

alt

命令行出現(xiàn)上面的文字，說明我們已經(jīng)初始化好了第一步。命令行提示我們現(xiàn)在可以作的三件事情。

cd vuecliTest 進入我們的vue項目目錄。
npm install 安裝我們的項目依賴包，也就是安裝package.json里的包，如果你網(wǎng)速不好，你也可以使用cnpm來安裝。
npm run dev 開發(fā)模式下運行我們的程序。給我們自動構(gòu)建了開發(fā)用的服務(wù)器環(huán)境和在瀏覽器中打開，并實時監(jiān)視我們的代碼更改，即時呈現(xiàn)給我們。

出現(xiàn)這個頁面，說明我們的初始化已經(jīng)成功，現(xiàn)在可以快樂的玩耍了。

項目結(jié)構(gòu)總結(jié)：

build：跟項目構(gòu)建有關(guān)的配置

config：跟項目開發(fā)環(huán)境有關(guān)的配置 node_modules：項目所用的包

src:需要開發(fā)的都放在這里 static:靜態(tài)文件

vue-cli腳手架工具就是為我們搭建了開發(fā)所需要的環(huán)境，為我們省去了很多精力。有必要對這個環(huán)境進行熟悉，我們就從項目的結(jié)構(gòu)講起。

Ps：由于版本實時更新和你選擇安裝的不同（這里列出的是模板為webpack的目錄結(jié)構(gòu)），所以你看到的有可能和下邊的有所差別。

.
|-- build                            // 項目構(gòu)建(webpack)相關(guān)代碼
|   |-- build.js                     // 生產(chǎn)環(huán)境構(gòu)建代碼
|   |-- check-version.js             // 檢查node、npm等版本
|   |-- dev-client.js                // 熱重載相關(guān)
|   |-- dev-server.js                // 構(gòu)建本地服務(wù)器
|   |-- utils.js                     // 構(gòu)建工具相關(guān)
|   |-- webpack.base.conf.js         // webpack基礎(chǔ)配置
|   |-- webpack.dev.conf.js          // webpack開發(fā)環(huán)境配置
|   |-- webpack.prod.conf.js         // webpack生產(chǎn)環(huán)境配置
|-- config                           // 項目開發(fā)環(huán)境配置
|   |-- dev.env.js                   // 開發(fā)環(huán)境變量
|   |-- index.js                     // 項目一些配置變量
|   |-- prod.env.js                  // 生產(chǎn)環(huán)境變量
|   |-- test.env.js                  // 測試環(huán)境變量
|-- src                              // 源碼目錄
|   |-- components                     // vue公共組件
|   |-- store                          // vuex的狀態(tài)管理
|   |-- App.vue                        // 頁面入口文件
|   |-- main.js                        // 程序入口文件，加載各種公共組件
|-- static                           // 靜態(tài)文件，比如一些圖片，json數(shù)據(jù)等
|   |-- data                           // 群聊分析得到的數(shù)據(jù)用于數(shù)據(jù)可視化
|-- .babelrc                         // ES6語法編譯配置
|-- .editorconfig                    // 定義代碼格式
|-- .gitignore                       // git上傳需要忽略的文件格式
|-- README.md                        // 項目說明
|-- favicon.ico 
|-- index.html                       // 入口頁面
|-- package.json                     // 項目基本信息
.

重要文件講解：

package.json package.json文件是項目根目錄下的一個文件，定義該項目開發(fā)所需要的各種模塊以及一些項目配置信息（如項目名稱、版本、描述、作者等）。

package.json 里的scripts字段，這個字段定義了你可以用npm運行的命令。在開發(fā)環(huán)境下，在命令行工具中運行npm run dev 就相當(dāng)于執(zhí)行 node build/dev-server.js .也就是開啟了一個node寫的開發(fā)行建議服務(wù)器。由此可以看出script字段是用來指定npm相關(guān)命令的縮寫。

"scripts": {
    "dev": "node build/dev-server.js",
    "build": "node build/build.js"
  },

dependencies字段和devDependencies字段

dependencies字段指項目運行時所依賴的模塊；
devDependencies字段指定了項目開發(fā)時所依賴的模塊；

在命令行中運行npm install命令，會自動安裝dependencies和devDempendencies字段中的模塊。

webpack配置相關(guān)

我們在上面說了運行npm run dev 就相當(dāng)于執(zhí)行了node build/dev-server.js,說明這個文件相當(dāng)重要，先來熟悉一下它。 我貼出代碼并給出重要的解釋。

dev-server.js

// 檢查 Node 和 npm 版本
require('./check-versions')()

// 獲取 config/index.js 的默認(rèn)配置
var config = require('../config')

// 如果 Node 的環(huán)境無法判斷當(dāng)前是 dev / product 環(huán)境
// 使用 config.dev.env.NODE_ENV 作為當(dāng)前的環(huán)境

if (!process.env.NODE_ENV) process.env.NODE_ENV = JSON.parse(config.dev.env.NODE_ENV)

// 使用 NodeJS 自帶的文件路徑工具
var path = require('path')

// 使用 express
var express = require('express')

// 使用 webpack
var webpack = require('webpack')

// 一個可以強制打開瀏覽器并跳轉(zhuǎn)到指定 url 的插件
var opn = require('opn')

// 使用 proxyTable
var proxyMiddleware = require('http-proxy-middleware')

// 使用 dev 環(huán)境的 webpack 配置
var webpackConfig = require('./webpack.dev.conf')

// default port where dev server listens for incoming traffic

// 如果沒有指定運行端口，使用 config.dev.port 作為運行端口
var port = process.env.PORT || config.dev.port

// Define HTTP proxies to your custom API backend
// https://github.com/chimurai/http-proxy-middleware

// 使用 config.dev.proxyTable 的配置作為 proxyTable 的代理配置
var proxyTable = config.dev.proxyTable

// 使用 express 啟動一個服務(wù)
var app = express()

// 啟動 webpack 進行編譯
var compiler = webpack(webpackConfig)

// 啟動 webpack-dev-middleware，將 編譯后的文件暫存到內(nèi)存中
var devMiddleware = require('webpack-dev-middleware')(compiler, {
  publicPath: webpackConfig.output.publicPath,
  stats: {
    colors: true,
    chunks: false
  }
})
 // 啟動 webpack-hot-middleware，也就是我們常說的 Hot-reload
var hotMiddleware = require('webpack-hot-middleware')(compiler)
// force page reload when html-webpack-plugin template changes
compiler.plugin('compilation', function (compilation) {
  compilation.plugin('html-webpack-plugin-after-emit', function (data, cb) {
    hotMiddleware.publish({ action: 'reload' })
    cb()
  })
})

// proxy api requests
// 將 proxyTable 中的請求配置掛在到啟動的 express 服務(wù)上
Object.keys(proxyTable).forEach(function (context) {
  var options = proxyTable[context]
  if (typeof options === 'string') {
    options = { target: options }
  }
  app.use(proxyMiddleware(context, options))
})

// handle fallback for HTML5 history API
// 使用 connect-history-api-fallback 匹配資源，如果不匹配就可以重定向到指定地址
app.use(require('connect-history-api-fallback')())

// serve webpack bundle output
// 將暫存到內(nèi)存中的 webpack 編譯后的文件掛在到 express 服務(wù)上
app.use(devMiddleware)

// enable hot-reload and state-preserving
// compilation error display
// 將 Hot-reload 掛在到 express 服務(wù)上
app.use(hotMiddleware)

// serve pure static assets
// 拼接 static 文件夾的靜態(tài)資源路徑
var staticPath = path.posix.join(config.dev.assetsPublicPath, config.dev.assetsSubDirectory)
// 為靜態(tài)資源提供響應(yīng)服務(wù)
app.use(staticPath, express.static('./static'))

// 讓我們這個 express 服務(wù)監(jiān)聽 port 的請求，并且將此服務(wù)作為 dev-server.js 的接口暴露
module.exports = app.listen(port, function (err) {
  if (err) {
    console.log(err)
    return
  }
  var uri = 'http://localhost:' + port
  console.log('Listening at ' + uri + '\n')

  // when env is testing, don't need open it
  // 如果不是測試環(huán)境，自動打開瀏覽器并跳到我們的開發(fā)地址
  if (process.env.NODE_ENV !== 'testing') {
    opn(uri)
  }
})

webpack.base.confg.js webpack的基礎(chǔ)配置文件

...
...
module.export = {
    // 編譯入口文件
    entry: {},
    // 編譯輸出路徑
    output: {},
    // 一些解決方案配置
    resolve: {},
    resolveLoader: {},
    module: {
        // 各種不同類型文件加載器配置
        loaders: {
        ...
        ...
        // js文件用babel轉(zhuǎn)碼
        {
            test: /\.js$/,
            loader: 'babel',
            include: projectRoot,
            // 哪些文件不需要轉(zhuǎn)碼
            exclude: /node_modules/
        },
        ...
        ...
        }
    },
    // vue文件一些相關(guān)配置
    vue: {}
}

.babelrc

Babel解釋器的配置文件，存放在根目錄下。Babel是一個轉(zhuǎn)碼器，項目里需要用它將ES6代碼轉(zhuǎn)為ES5代碼。如果你想了解更多，可以查看babel的知識。

{
  //設(shè)定轉(zhuǎn)碼規(guī)則
  "presets": [
    ["env", { "modules": false }],
    "stage-2"
  ],
  //轉(zhuǎn)碼用的插件
  "plugins": ["transform-runtime"],
  "comments": false,
  //對BABEL_ENV或者NODE_ENV指定的不同的環(huán)境變量，進行不同的編譯操作
  "env": {
    "test": {
      "presets": ["env", "stage-2"],
      "plugins": [ "istanbul" ]
    }
  }
}

.editorconfig

該文件定義項目的編碼規(guī)范，編譯器的行為會與.editorconfig文件中定義的一致，并且其優(yōu)先級比編譯器自身的設(shè)置要高，這在多人合作開發(fā)項目時十分有用而且必要。

root = true

[*]    // 對所有文件應(yīng)用下面的規(guī)則
charset = utf-8                    // 編碼規(guī)則用utf-8
indent_style = space               // 縮進用空格
indent_size = 2                    // 縮進數(shù)量為2個空格
end_of_line = lf                   // 換行符格式
insert_final_newline = true        // 是否在文件的最后插入一個空行
trim_trailing_whitespace = true    // 是否刪除行尾的空格

這是比較重要的關(guān)于vue-cli的配置文件，當(dāng)然還有很多文件，我們會在以后的文章中講解。

解讀Vue-cli模板

npm run build 進行打包

生成dist文件目錄

dist就是需要上傳到服務(wù)器的文件
static和index.html

解讀模板： src下面的main.js是入口文件-主要的是App.vue： base-config-main.js-router和 router-index.js-Hello.vue 尋找入口