手摸手教你搭建vue-cli腳手架-詳細步驟圖文解析[vue入門]

寫在前面：

使用 vue-cli 能夠快速建立 vue 項目，vue-cli很好用，可是在最初搭建環境安裝vue-cli及相關內容的時候，對一些人來講是很頭疼的一件事情，本人在搭建vue-cli的項目環境的時候也是踩了至關多的坑，特此寫了一篇搭建環境的教程，每一步儘可能詳細解析。須要的朋友能夠過來參考下，喜歡的能夠點波贊，或者關注一下本人，但願能夠幫到你們。

vue-cli腳手架的優點：

1. 有一套成熟的vue項目架構設計,可以快速初始化一個Vue項目.
2. vue-cli是官方支持的一個腳手架，會隨本版本進行迭代更新。
3. vue-cli提供了一套本地的node測試服務器，使用vue-cli本身提供的命令，就能夠啓動服務器。
4. 集成打包上線方案。

5. 還有一些優勢，包括：模塊化，轉譯，預處理，熱加載，靜態檢測和自動化測試等，等你們深刻使用下去就會發現vue-cli的強大之處。

本教程是基於windows系統。

下面正式開始搭建vue-cli腳手架。

命令行工具

命令行工具是咱們操做npm的基礎，這個必需要有的，不少教程沒有寫清楚，那些教程一上來就貼上一大堆命令，當初也不知道在哪裏使用命令行工具。。。

git bash命令行工具

1. windows下本人推薦使用GitHub的桌面管理工具自帶的git bash命令行工具，正常下載安裝就能夠。

2. 下載地址，下圖是下載安裝完成以後，git bash的使用方法。

ps:固然若是想使用自帶的終端cmd命令行工具也是能夠，可是畢竟沒有git bash來的好用方便。

安裝node.js

1. 在node.js中文官網正常下載安裝node.js就能夠，沒有什麼特別須要注意的點（傻瓜式安裝）。

2. 在官網下載安裝node.js後，就已經自帶npm（包管理工具），不須要另外再進行安裝npm了。

3. 注意下載node.js版本要在4.0以上，避免版本太低影響使用。

4. 打開命令行工具（隨便哪一個文件夾），輸入命令行 node -v，npm -v，以下圖，若是出現相應的版本號，則說明安裝成功。

安裝淘寶鏡像

cnpm（淘寶鏡像）相關：

1. 這是一個完整 npmjs.org 鏡像，是用來同步npm上面的模塊。
2. cnpm的同步頻率爲 10分鐘 （新發布的模塊有滯後性，同步是須要時間的，等不及的可使用npm）。
3. 安裝cnpm的緣由：npm的服務器是外國的，因此有時候咱們安裝「模塊」會很很慢很慢超級慢。
4. cnpm的做用：淘寶鏡像將npm上面的模塊同步到國內服務器，提升咱們安裝模塊的時間。
5. 安裝完淘寶鏡像以後，cnpm和npm命令行皆可以使用，兩者並不衝突 
   

安裝方法：打開命令行工具，輸入命令行：

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

• 1
• 2

cnpm使用方法:

$ cnpm install [name]

• 1
• 2

安裝模塊的時候，將npm換成cnpm就行，國內不少coder都是使用cnpm的，我的建議你們都裝一下，附上：淘寶鏡像網址、

安裝webpack

安裝方法：打開命令行工具，輸入命令行：

npm install webpack -g

• 1
• 2

安裝成功後輸入webpack -v,若是出現相應的版本號，則說明安裝成功。

安裝vue-cli腳手架構建工具

安裝方法：全局安裝，隨便一個文件夾，輸入命令行：

npm install vue-cli -g

• 1
• 2

安裝完成以後，輸入命令行vue -V查看版本號，出現相應獲得版本號即爲成功：

注：這裏是大寫的V

經過vue-cli，初始化vue項目

經過以上幾步，將咱們安裝腳手架所須要的環境和工具都準備好好了，下面就可使用vue-cli來初始化項目。

1。新建一個vuetext（項目名）文件夾來放置項目，

在新建文件夾的上一級文件夾右鍵打開命令行工具，輸入命令行：

vue init webpack vuetext1(項目名)

• 1
• 2

注：項目名不能大寫，不能使用中文 
解釋一下這個命令，這個命令的意思是初始化一個vue項目，其中webpack是構建工具，也就是整個項目是基於webpack的。其中vuetext1是整個項目文件夾的名稱，這個文件夾會自動生成在你指定的目錄中。

2。如下是腳手架安裝過程（安裝步驟解析在圖片下面）

vue-cli初始化項目選項配置詳細解析

$ vue init webpack vuetext1--------------------- 安裝vue-cli,初始化vue項目的命令
? Target directory exists. Continue? (Y/n) y---------------------找到了vuetext1這個目錄是否要繼續
? Target directory exists. Continue? Yes
? Project name (vuetext1)---------------------項目的名稱（默認是文件夾的名稱），ps：項目的名稱不能有大寫，不能有中文，不然會報錯
? Project name vuetext1
? Project description (A Vue.js project)---------------------項目描述，能夠本身寫
? Project description A Vue.js project
? Author (OBKoro1)---------------------項目建立者
? Author OBKoro1 
? Vue build (Use arrow keys)--------------------選擇打包方式，有兩種方式（runtime和standalone），使用默認便可
? Vue build standalone
? Install vue-router? (Y/n) y--------------------是否安裝路由，通常都要安裝
? Install vue-router? Yes
? Use ESLint to lint your code? (Y/n) n---------------------是否啓用eslint檢測規則，這裏我的建議選no，由於常常會各類代碼報錯，新手仍是不安裝好
? Use ESLint to lint your code? No
? Setup unit tests with Karma + Mocha? (Y/n)--------------------是否安裝單元測試
? Setup unit tests with Karma + Mocha? Yes
? Setup e2e tests with Nightwatch? (Y/n) y)--------------------是否安裝e2e測試 
? Setup e2e tests with Nightwatch? Yes

vue-cli · Generated "vuetext1".
To get started:)--------------------如何開始
 cd vuetext1)--------------------進入你安裝的項目
 npm install)--------------------安裝項目依賴
 npm run dev)--------------------運行項目
Documentation can be found at https://vuejs-templates.github.io/webpack)--------------------vue-cli官方文檔

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27

如今vuetext1項目已經初步初始化完成了，裏面也有一些文件，可是如今還不能成功運行。

3.如何運行項目

1. 進入你剛纔建立在vuetext1項目的文件夾裏面，在vuetext1項目的文件夾裏面右鍵運行git bash 命令行工具。

2. 安裝項目依賴。命令行： npm install。前面在項目初始化的時候，已經存在了package.json文件，直接使用npm install 安裝項目所須要的依賴，不然項目不能正確運行。

   建立完成的「vuetext1」目錄以下：

3. 到這裏，咱們已經成功使用vue-cli初始化了一個vue項目。

   啓動項目：

   在vuetext1目錄運行命令行npm run dev，啓動服務，服務啓動成功後瀏覽器會默認打開一個「歡迎頁面」，以下圖。

注意：這裏是默認服務啓動的是本地的8080端口，因此請確保你的8080端口不被別的程序所佔用，當有其餘vue項目運行的時候，可使用ctrl+c來中斷運行。

結語：

本文關於如何搭建vue-cli腳手架已經儘可能詳細了，仔細閱讀，按步驟來基本上能夠成功。若是有哪一個地方寫的不夠清楚的，歡迎指正。本文面向小白，寫着玩，大手請輕噴。