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

OBKoro1發表於2017-08-05

寫在前面:

使用 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的使用方法。

git bash命令列工具的使用方法
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 -vnpm -v,如下圖,如果出現相應的版本號,則說明安裝成功。

檢測node npm安裝情
檢測node npm安裝情

安裝淘寶映象

cnpm(淘寶映象)相關:

  1. 這是一個完整 npmjs.org 映象,是用來同步npm上面的模組
  2. cnpm的同步頻率為 10分鐘 (新發布的模組有滯後性,同步是需要時間的,等不及的可以使用npm)。
  3. 安裝cnpm的原因:npm的伺服器是外國的,所以有時候我們安裝“模組”會很很慢很慢超級慢。
  4. cnpm的作用:淘寶映象將npm上面的模組同步到國內伺服器,提高我們安裝模組的時間。
  5. 安裝完淘寶映象之後,cnpmnpm命令列皆可使用,二者並不衝突
    截圖出自淘寶映象官網
    截圖出自淘寶映象官網

安裝方法:開啟命令列工具,輸入命令列:

$ 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檢視版本號,出現相應得到版本號即為成功:

檢視vue-cli是否安裝成功
檢視vue-cli是否安裝成功

注:這裡是大寫的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.如何執行專案

  1. 進入你剛才建立在vuetext1專案的資料夾裡面,在vuetext1專案的資料夾裡面右鍵執行git bash 命令列工具
  2. 安裝專案依賴。命令列: npm install。前面在專案初始化的時候,已經存在了package.json檔案,直接使用npm install 安裝專案所需要的依賴,否則專案不能正確執行。

    建立完成的“vuetext1”目錄如下:

    建立完成的專案結構
    建立完成的專案結構

  3. 到這裡,我們已經成功使用vue-cli初始化了一個vue專案。

    啟動專案:

    在vuetext1目錄執行命令列npm run dev,啟動服務,服務啟動成功後瀏覽器會預設開啟一個“歡迎頁面”,如下圖。

vue-cli專案成功啟動
vue-cli專案成功啟動

注意:這裡是預設服務啟動的是本地的8080埠,所以請確保你的8080埠不被別的程式所佔用,當有其他vue專案執行的時候,可以使用ctrl+c來中斷執行。

vue-cli配置相關:

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

結語:

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

最後:如需轉載,請放上原文連結並署名。碼字不易,感謝支援!寫文偏小白,寫的不好之處,歡迎指點。然後就是希望看完的朋友點個喜歡,也可以關注一下我。
掘金個人主頁

相關文章