原文鏈接：https://jspang.com/detailed?id=26#toc46
Vue-cli 免費(fèi)視頻教程
2019-12-05 視頻教程 13339 共3集
Vue-cli是vue官方出品的快速構(gòu)建單頁(yè)應(yīng)用的腳手架，如果你是初次嘗試Vue锦溪，我不建議使用墅诡，推薦你老老實(shí)實(shí)用普通引入javascript文件的方式進(jìn)行學(xué)習(xí)（你可以去看我的vue視頻教程的1-4季），這里牽扯的東西很多，有webpack，npm，nodejs撒璧，babel等等，很容易產(chǎn)生從入門就放棄的思想笨使。
## 第1節(jié)：Vue-cli卿樱，開始吧騷年 <iframe frameborder="0" width="100%" src="https://v.qq.com/iframe/player.html?vid=w0392e8jcod&tiny=0&auto=0" allowfullscreen="" style="box-sizing: border-box; height: 34rem; border: 1px solid rgb(204, 204, 204); border-radius: 8px;"></iframe> ### 一、安裝vue-cli
安裝vue-cli的前提是你已經(jīng)安裝了npm阱表，安裝npm你可以直接下載node的安裝包進(jìn)行安裝殿如。你可以在命令行工具里輸入npm -v 檢測(cè)你是否安裝了npm和版本情況。出現(xiàn)版本號(hào)說(shuō)明你已經(jīng)安裝了npm和node最爬，我這里的npm版本為3.10.10。如果該命令不可以使用门岔，需要安裝node軟件包爱致，根據(jù)你的系統(tǒng)版本選擇下載安裝就可以了。
下載地址：http://nodejs.cn/download/
[圖片上傳失敗...(image-a2db6e-1597913071336)]
npm沒(méi)有問(wèn)題寒随，接下來(lái)我們可以用npm 命令安裝vue-cli了糠悯，在命令行輸入下面的命令：
npm install vue-cli -g
- -g :代表全局安裝。如果你安裝時(shí)報(bào)錯(cuò)妻往，一般是網(wǎng)絡(luò)問(wèn)題互艾，你可以嘗試用cnpm來(lái)進(jìn)行安裝。安裝完成后讯泣，可以用vue
- -V來(lái)進(jìn)行查看 vue-cli的版本號(hào)纫普。注意這里的V是大寫的。我這里版本號(hào)是2.8.1.
[圖片上傳失敗...(image-d19092-1597913071336)]
如果vue -V的命令管用了好渠，說(shuō)明已經(jīng)順利的把vue-cli安裝到我們的計(jì)算機(jī)里了昨稼。
我們用vue init命令來(lái)初始化項(xiàng)目，具體看一下這條命令的使用方法假栓。
$ vue init <template-name> <project-name>
init：表示我要用vue-cli來(lái)初始化項(xiàng)目
<template-name>：表示模板名稱寻行，vue-cli官方為我們提供了5種模板，
webpack-一個(gè)全面的webpack+vue-loader的模板匾荆，功能包括熱加載拌蜘，linting,檢測(cè)和CSS擴(kuò)展。
webpack-simple-一個(gè)簡(jiǎn)單webpack+vue-loader的模板牙丽，不包含其他功能简卧，讓你快速的搭建vue的開發(fā)環(huán)境。
browserify-一個(gè)全面的Browserify+vueify 的模板剩岳，功能包括熱加載贞滨，linting,單元檢測(cè)。
browserify-simple-一個(gè)簡(jiǎn)單Browserify+vueify的模板拍棕，不包含其他功能晓铆，讓你快速的搭建vue的開發(fā)環(huán)境。
-simple-一個(gè)最簡(jiǎn)單的單頁(yè)應(yīng)用模板绰播。
<project-name>：標(biāo)識(shí)項(xiàng)目名稱骄噪，這個(gè)你可以根據(jù)自己的項(xiàng)目來(lái)起名字。
在實(shí)際開發(fā)中蠢箩，一般我們都會(huì)使用webpack這個(gè)模板链蕊，那我們這里也安裝這個(gè)模板，在命令行輸入以下命令：
vue init webpack vuecliTest
輸入命令后谬泌，會(huì)詢問(wèn)我們幾個(gè)簡(jiǎn)單的選項(xiàng)滔韵，我們根據(jù)自己的需要進(jìn)行填寫就可以了。
- Project name :項(xiàng)目名稱 掌实，如果不需要更改直接回車就可以了陪蜻。注意：這里不能使用大寫，所以我把名稱改成了vueclitest
- Project description:項(xiàng)目描述贱鼻，默認(rèn)為A Vue.js project,直接回車宴卖，不用編寫。
- Author：作者邻悬，如果你有配置git的作者症昏，他會(huì)讀取。
- Install vue-router? 是否安裝vue的路由插件父丰，我們這里需要安裝肝谭，所以選擇Y
- Use ESLint to lint your code? 是否用ESLint來(lái)限制你的代碼錯(cuò)誤和風(fēng)格。我們這里不需要輸入n，如果你是大型團(tuán)隊(duì)開發(fā)分苇，最好是進(jìn)行配置添诉。
- setup unit tests with Karma + Mocha? 是否需要安裝單元測(cè)試工具Karma+Mocha，我們這里不需要医寿，所以輸入n栏赴。
- Setup e2e tests with Nightwatch?是否安裝e2e來(lái)進(jìn)行用戶行為模擬測(cè)試，我們這里不需要靖秩，所以輸入n须眷。
[圖片上傳失敗...(image-47990f-1597913071336)]
命令行出現(xiàn)上面的文字，說(shuō)明我們已經(jīng)初始化好了第一步沟突。命令行提示我們現(xiàn)在可以作的三件事情花颗。
-
cd vuecliTest進(jìn)入我們的vue項(xiàng)目目錄。 -
npm install安裝我們的項(xiàng)目依賴包惠拭，也就是安裝package.json里的包扩劝，如果你網(wǎng)速不好，你也可以使用cnpm來(lái)安裝职辅。 -
npm run dev開發(fā)模式下運(yùn)行我們的程序棒呛。給我們自動(dòng)構(gòu)建了開發(fā)用的服務(wù)器環(huán)境和在瀏覽器中打開，并實(shí)時(shí)監(jiān)視我們的代碼更改域携，即時(shí)呈現(xiàn)給我們簇秒。
[圖片上傳失敗...(image-d5cb87-1597913071336)]
出現(xiàn)這個(gè)頁(yè)面，說(shuō)明我們的初始化已經(jīng)成功秀鞭，現(xiàn)在可以快樂(lè)的玩耍了趋观。
## 第2節(jié)：Vue-cli項(xiàng)目結(jié)構(gòu)講解 <iframe frameborder="0" width="100%" src="https://v.qq.com/iframe/player.html?vid=g0392zq9ltq&tiny=0&auto=0" allowfullscreen="" style="box-sizing: border-box; height: 34rem; border: 1px solid rgb(204, 204, 204); border-radius: 8px;"></iframe>
vue-cli腳手架工具就是為我們搭建了開發(fā)所需要的環(huán)境，為我們省去了很多精力锋边。有必要對(duì)這個(gè)環(huán)境進(jìn)行熟悉皱坛，我們就從項(xiàng)目的結(jié)構(gòu)講起。
Ps：由于版本實(shí)時(shí)更新和你選擇安裝的不同（這里列出的是模板為webpack的目錄結(jié)構(gòu)）豆巨，所以你看到的有可能和下邊的有所差別麸恍。
.
|-- build // 項(xiàng)目構(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 // 項(xiàng)目開發(fā)環(huán)境配置
| |-- dev.env.js // 開發(fā)環(huán)境變量
| |-- index.js // 項(xiàng)目一些配置變量
| |-- prod.env.js // 生產(chǎn)環(huán)境變量
| |-- test.env.js // 測(cè)試環(huán)境變量
|-- src // 源碼目錄
| |-- components // vue公共組件
| |-- store // vuex的狀態(tài)管理
| |-- App.vue // 頁(yè)面入口文件
| |-- main.js // 程序入口文件搀矫，加載各種公共組件
|-- static // 靜態(tài)文件，比如一些圖片刻肄，json數(shù)據(jù)等
| |-- data // 群聊分析得到的數(shù)據(jù)用于數(shù)據(jù)可視化
|-- .babelrc // ES6語(yǔ)法編譯配置
|-- .editorconfig // 定義代碼格式
|-- .gitignore // git上傳需要忽略的文件格式
|-- README.md // 項(xiàng)目說(shuō)明
|-- favicon.ico
|-- index.html // 入口頁(yè)面
|-- package.json // 項(xiàng)目基本信息
.
重要文件講解：
package.json package.json文件是項(xiàng)目根目錄下的一個(gè)文件瓤球，定義該項(xiàng)目開發(fā)所需要的各種模塊以及一些項(xiàng)目配置信息（如項(xiàng)目名稱、版本敏弃、描述卦羡、作者等）。
package.json 里的scripts字段，這個(gè)字段定義了你可以用npm運(yùn)行的命令绿饵。在開發(fā)環(huán)境下欠肾，在命令行工具中運(yùn)行npm run dev 就相當(dāng)于執(zhí)行 node build/dev-server.js .也就是開啟了一個(gè)node寫的開發(fā)行建議服務(wù)器。由此可以看出script字段是用來(lái)指定npm相關(guān)命令的縮寫拟赊。
"scripts": {
"dev": "node build/dev-server.js",
"build": "node build/build.js"
},
dependencies字段和devDependencies字段
-
dependencies字段指項(xiàng)目運(yùn)行時(shí)所依賴的模塊刺桃； -
devDependencies字段指定了項(xiàng)目開發(fā)時(shí)所依賴的模塊；
在命令行中運(yùn)行npm install命令吸祟，會(huì)自動(dòng)安裝dependencies和devDempendencies字段中的模塊瑟慈。package.json還有很多相關(guān)配置，如果你想全面了解屋匕，可以專門去百度學(xué)習(xí)一下葛碧。
我們?cè)谏厦嬲f(shuō)了運(yùn)行npm run dev 就相當(dāng)于執(zhí)行了node build/dev-server.js,說(shuō)明這個(gè)文件相當(dāng)重要，先來(lái)熟悉一下它过吻。 我貼出代碼并給出重要的解釋进泼。
dev-server.js
// 檢查 Node 和 npm 版本
require('./check-versions')()
// 獲取 config/index.js 的默認(rèn)配置
var config = require('../config')
// 如果 Node 的環(huán)境無(wú)法判斷當(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')
// 一個(gè)可以強(qiáng)制打開瀏覽器并跳轉(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
// 如果沒(méi)有指定運(yùn)行端口，使用 config.dev.port 作為運(yùn)行端口
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 啟動(dòng)一個(gè)服務(wù)
var app = express()
// 啟動(dòng) webpack 進(jìn)行編譯
var compiler = webpack(webpackConfig)
// 啟動(dòng) webpack-dev-middleware纤虽，將 編譯后的文件暫存到內(nèi)存中
var devMiddleware = require('webpack-dev-middleware')(compiler, {
publicPath: webpackConfig.output.publicPath,
stats: {
colors: true,
chunks: false
}
})
// 啟動(dòng) webpack-hot-middleware乳绕，也就是我們常說(shuō)的 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 中的請(qǐng)求配置掛在到啟動(dòng)的 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'))
// 讓我們這個(gè) express 服務(wù)監(jiān)聽 port 的請(qǐng)求廓推，并且將此服務(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
// 如果不是測(cè)試環(huán)境刷袍，自動(dòng)打開瀏覽器并跳到我們的開發(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: {}
}
這里有很多webpack的知識(shí)，我也有一個(gè)專門講webpack的視頻教程.
Babel解釋器的配置文件樊展，存放在根目錄下呻纹。Babel是一個(gè)轉(zhuǎn)碼器，項(xiàng)目里需要用它將ES6代碼轉(zhuǎn)為ES5代碼专缠。如果你想了解更多雷酪，可以查看babel的知識(shí)。
{
//設(shè)定轉(zhuǎn)碼規(guī)則
"presets": [
["env", { "modules": false }],
"stage-2"
],
//轉(zhuǎn)碼用的插件
"plugins": ["transform-runtime"],
"comments": false,
//對(duì)BABEL_ENV或者NODE_ENV指定的不同的環(huán)境變量涝婉，進(jìn)行不同的編譯操作
"env": {
"test": {
"presets": ["env", "stage-2"],
"plugins": [ "istanbul" ]
}
}
}
該文件定義項(xiàng)目的編碼規(guī)范哥力，編譯器的行為會(huì)與.editorconfig文件中定義的一致，并且其優(yōu)先級(jí)比編譯器自身的設(shè)置要高墩弯，這在多人合作開發(fā)項(xiàng)目時(shí)十分有用而且必要吩跋。
root = true
[*] // 對(duì)所有文件應(yīng)用下面的規(guī)則
charset = utf-8 // 編碼規(guī)則用utf-8
indent_style = space // 縮進(jìn)用空格
indent_size = 2 // 縮進(jìn)數(shù)量為2個(gè)空格
end_of_line = lf // 換行符格式
insert_final_newline = true // 是否在文件的最后插入一個(gè)空行
trim_trailing_whitespace = true // 是否刪除行尾的空格
這是比較重要的關(guān)于vue-cli的配置文件，當(dāng)然還有很多文件渔工，我們會(huì)在以后的文章中講解锌钮。
我們通過(guò)兩節(jié)課的講解，你對(duì)vue-cli應(yīng)該有了基本的了解引矩，這節(jié)我們主要了解一下Vue-cli的模板操作梁丘，包括增加模板侵浸，修改模板，以及一個(gè)常規(guī)模板的基本結(jié)構(gòu)氛谜。
<iframe frameborder="0" width="100%" src="https://v.qq.com/iframe/player.html?vid=d0392v00bcl&tiny=0&auto=0" allowfullscreen="" style="box-sizing: border-box; height: 34rem; border: 1px solid rgb(204, 204, 204); border-radius: 8px;"></iframe> ### 一掏觉、npm run build 命令
有小伙伴問(wèn)我，如何把寫好的Vue網(wǎng)頁(yè)放到服務(wù)器上值漫，那我就在這里講解一下澳腹，主要的命令就是要用到npm run build 命令。我們?cè)诿钚兄休斎雗pm run build命令后惭嚣，vue-cli會(huì)自動(dòng)進(jìn)行項(xiàng)目發(fā)布打包遵湖。你在package.json文件的scripts字段中可以看出，你執(zhí)行的npm run build命令就相對(duì)執(zhí)行的 node build/build.js 晚吞。
package.json的scripts 字段：
"scripts": {
"dev": "node build/dev-server.js",
"build": "node build/build.js"
},
在執(zhí)行完npm run build命令后延旧，在你的項(xiàng)目根目錄生成了dist文件夾，這個(gè)文件夾里邊就是我們要傳到服務(wù)器上的文件槽地。
dist文件夾下目錄包括：
-
index.html主頁(yè)文件:因?yàn)槲覀冮_發(fā)的是單頁(yè)web應(yīng)用迁沫，所以說(shuō)一般只有一個(gè)html文件。 - static 靜態(tài)資源文件夾：里邊js捌蚊、CSS和一些圖片集畅。
main.js是整個(gè)項(xiàng)目的入口文件,在src文件夾下：
import Vue from 'vue'
import App from './App'
import router from './router'
Vue.config.productionTip = false //生產(chǎn)環(huán)境提示缅糟，這里設(shè)置成了false
/* eslint-disable no-new */
new Vue({
el: '#app',
router,
template: '<App/>',
components: { App }
})
通過(guò)代碼可以看出這里引進(jìn)了App的組件和<app style="box-sizing: border-box;">的模板挺智，它是通過(guò) import App from ‘./App’這句代碼引入的。 我們找到App.vue文件窗宦，打開查看赦颇。</app>
<template>
<div id="app">
<img src="./assets/logo.png">
<router-view></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>
app.vue文件我們可以分成三部分解讀，
-
<template></template>標(biāo)簽包裹的內(nèi)容：這是模板的HTMLDom結(jié)構(gòu)赴涵，里邊引入了一張圖片和<router-view></router-view>標(biāo)簽媒怯，<router-view>標(biāo)簽說(shuō)明使用了路由機(jī)制。我們會(huì)在以后專門拿出一篇文章講Vue-router髓窜。 -
<script></script>標(biāo)簽包括的js內(nèi)容：你可以在這里些一些頁(yè)面的動(dòng)態(tài)效果和Vue的邏輯代碼扇苞。 -
<style></style>標(biāo)簽包裹的css內(nèi)容：這里就是你平時(shí)寫的CSS樣式，對(duì)頁(yè)面樣子進(jìn)行裝飾用的寄纵，需要特別說(shuō)明的是你可以用<style scoped></style>來(lái)聲明這些css樣式只在本模板中起作用鳖敷。
引文在app.vue中我們看到了路由文件程拭，雖然router的內(nèi)容比較多哄陶，但是我們先簡(jiǎn)單的看一下。下篇文章我們就開始講Vue-router哺壶。
import Vue from 'vue'
import Router from 'vue-router'
import Hello from '@/components/Hello'
Vue.use(Router)
export default new Router({
routes: [
{
path: '/',
name: 'Hello',
component: Hello
}
]
})
我們可以看到 import Hello from ‘@/components/Hello’這句話屋吨， 文件引入了/components/Hello.vue文件。這個(gè)文件里就配置了一個(gè)路由山宾，就是當(dāng)我們?cè)L問(wèn)網(wǎng)站時(shí)給我們顯示Hello.vue的內(nèi)容至扰。
這個(gè)文件就是我們?cè)诘谝还?jié)課看到的頁(yè)面文件了资锰。也是分為<template><script><style>三個(gè)部分敢课，以后我們大部分的工作都是寫這些.vue結(jié)尾的文件。現(xiàn)在我們可以試著改一些內(nèi)容绷杜，然后預(yù)覽一下直秆。
<template>
<div class="hello">
<h1>{{ msg }}</h1>
<h2>Essential Links</h2>
<ul>
<li><a target="_blank">Core Docs</a></li>
<li><a target="_blank">Forum</a></li>
<li><a target="_blank">Gitter Chat</a></li>
<li><a target="_blank">Twitter</a></li>
<br>
<li><a target="_blank">Docs for This Template</a></li>
</ul>
<h2>Ecosystem</h2>
<ul>
<li><a target="_blank">vue-router</a></li>
<li><a target="_blank">vuex</a></li>
<li><a target="_blank">vue-loader</a></li>
<li><a target="_blank">awesome-vue</a></li>
</ul>
</div>
</template>
<script>
export default {
name: 'hello',
data () {
return {
msg: 'Welcome to Your Vue.js App'
}
}
}
</script>
<!-- Add "scoped" attribute to limit CSS to this component only -->
<style scoped>
h1, h2 {
font-weight: normal;
}
ul {
list-style-type: none;
padding: 0;
}
li {
display: inline-block;
margin: 0 10px;
}
a {
color: #42b983;
}
</style>
總結(jié)： 這個(gè)教程只是帶著你大概瀏覽和重點(diǎn)講解了vue-cli的知識(shí)，如果你想完全弄明白vue-cli鞭盟，我建議最好是有調(diào)理的閱讀所有代碼圾结，這對(duì)你以后成為vue實(shí)際項(xiàng)目 的開發(fā)很有幫助。如果你是一個(gè)初學(xué)者齿诉，了解這些已經(jīng)足夠向下學(xué)習(xí)了筝野。這篇教程結(jié)束后，我們會(huì)學(xué)習(xí)vue-router的知識(shí)粤剧，vue-router是一個(gè)重點(diǎn)學(xué)習(xí)任務(wù)歇竟，我會(huì)竭盡所能把路由的知識(shí)都講透。很高興大家能和我一起學(xué)習(xí)抵恋，我們下篇教程見(jiàn)了焕议。
