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

寫在前面：

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

vue-cli腳手架的優點：

有一套成熟的vue項目架構設計,可以快速初始化一個Vue項目.
vue-cli是官方支持的一個腳手架，會隨本版本進行迭代更新。
vue-cli提供了一套本地的node測試服務器，使用vue-cli本身提供的命令，就能夠啓動服務器。
集成打包上線方案。
還有一些優勢，包括：模塊化，轉譯，預處理，熱加載，靜態檢測和自動化測試等，等你們深刻使用下去就會發現vue-cli的強大之處。

本教程是基於windows系統。

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

命令行工具

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

git bash命令行工具

windows下本人推薦使用GitHub的桌面管理工具自帶的git bash命令行工具，正常下載安裝就能夠。webpack
下載地址，下圖是下載安裝完成以後，git bash的使用方法。git

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

安裝node.js

在node.js中文官網正常下載安裝node.js就能夠，沒有什麼特別須要注意的點（傻瓜式安裝）。web
在官網下載安裝node.js後，就已經自帶npm（包管理工具），不須要另外再進行安裝npm了。vue-router
注意下載node.js版本要在4.0以上，避免版本太低影響使用。
打開命令行工具（隨便哪一個文件夾），輸入命令行 node -v，npm -v，以下圖，若是出現相應的版本號，則說明安裝成功。vue-cli

安裝淘寶鏡像

cnpm（淘寶鏡像）相關：

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

截圖出自淘寶鏡像官網

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

$ npm install -g cnpm --registry=https://registry.npm.taobao.org複製代碼

cnpm使用方法:

$ cnpm install [name]複製代碼

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

安裝webpack

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

npm install webpack -g複製代碼

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

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

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

npm install vue-cli -g複製代碼

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

注：這裏是大寫的V

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

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

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

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

vue init webpack vuetext1(項目名)複製代碼

注：項目名不能大寫，不能使用中文
解釋一下這個命令，這個命令的意思是初始化一個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官方文檔複製代碼

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

3.如何運行項目

進入你剛纔建立在vuetext1項目的文件夾裏面，在vuetext1項目的文件夾裏面右鍵運行git bash 命令行工具。
安裝項目依賴。命令行： npm install。前面在項目初始化的時候，已經存在了package.json文件，直接使用npm install 安裝項目所須要的依賴，不然項目不能正確運行。

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

建立完成的項目結構
到這裏，咱們已經成功使用vue-cli初始化了一個vue項目。

啓動項目：

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

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

vue-cli配置相關:

這是我寫的另一篇關於vue-cli配置相關的文章，有須要的朋友能夠參考一下。
在vue-cli腳手架中引用JQuery、bootstrap以及使用sass、less編寫css[vue-cli配置入門]

結語：

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

最後：如需轉載，請放上原文連接並署名。碼字不易，感謝支持！寫文偏小白，寫的很差之處，歡迎指點。而後就是但願看完的朋友點個喜歡，也能夠關注一下我。
掘金我的主頁