建立vue新專案與設定

Jess
再不寫就要忘了
Sep 28, 2020
  1. 專案結構:vue2 + vue cli4
  2. 使用工具:yarn

一、安裝vue cli

打開終端機,輸入:

$ yarn global add @vue/cli
$ vue -V //檢查是否有安裝到vue-cli

預期結果終端機會出現:

@vue/cli 4.5.6

參考官網

二、建立專案

$ cd playground  //移動到平常放專案的地方
$ vue create my-project //my-project是自己取的專案名稱

這時候會出現一連串的選項要你選擇:

  1. Please pick a preset : Manually select features 選擇手動
  2. Check the features needed for your project : 選起以下這些 ( 上下鍵移動、空白鍵選取、enter確認)
  • Choose Vue version (vue3出來了,所以他現在可以讓你選)
  • Babel
  • Router
  • Vuex
  • CSS Pre-processors (你要用sass就要選起來)
  • Linter / Formatter (多人協作的話,最好是選起來,統一大家程式碼)

3. Choose a version of Vue.js that you want to start the project with : 2.x (因為vue3還沒學,所以先選 2.x XDD)

4. Use history mode for router? : Y (看你網頁的路徑要不要顯示#

5. Pick a CSS pre-processor : Sass/SCSS (with node-sass)

6. Pick a linter / formatter config : ESLint + Prettier (通常是檢查跟排版都開)

7. Pick additional lint features : Lint on save (儲存的時候就自動檢查,超方便)

8. Where do you prefer placing config for Babel, ESLint, etc.? : In dedicated config files (全部都獨立的設定檔比較好管理)

9. Save this as a preset for future projects? (y/N) N (你覺得你日後懶得每次建專案都這樣選,你就可以把這次的設定存起來,選y

三、設定prettier

如果很多人一起合作一個專案,每個人的設定都不同,萬一某一天你只是要修改別人的一行程式,但是會因為你的排版設定跟他不同,你的編輯器又會自動把整個檔案重新排版,你就會發現git修改記錄變得非常多,而且都只是排版的調整,日後再看這條commit,就會很難發現你真正修改的邏輯是在哪裡。

  1. 根目錄新增檔案.prettierrc.js
  2. 內容可以依照自己的喜好輸入:

終端機輸入指令,把全部檔案依照你的設定跑一遍

$ prettier --write .

注意,最後面有一個.,表示執行現在所在位置的資料夾。

如果他找不到指令,請先全域安裝prettier

$ yarn global add prettier

四、自動化排序.vue 檔內的Component/instance順序

就是你在撰寫.vue 檔案的時候,datacomputedmethods...那些的順序,不管是不是多人協作,都建議要統一。

vue官網有推薦的順序,參考這裡

  1. .eslintrc.js檔案中

2. 要在儲存的時候自動format,在vscodesettings.json 中:

"editor.codeActionsOnSave": {
"source.fixAll.eslint": true
},

五、axios設定

如果你的網站會需要跟後端溝通走http協定,vue2.0以後都是推薦使用axios套件,所以就把它裝起來吧!

  1. 安裝axios
$ yarn add axios

2. 新增api.js檔案(可以建立一個utils資料夾,裡面放各種工具js檔)

api.js

其中的baseURL 可以設定在環境變數,依照不同環境切換domain。

在頁面中使用:

六、設定環境變數

通常在開發一個專案,會有工程師使用的development開發環境、test/sit測試環境、production正式(打包)上線環境,這三種環境可能在某些設定上會不一樣,這時候可以利用環境變數把三個環境不同的參數設定在各自檔案中去切換。

在根目錄中新增環境變數檔案,通常有以下兩種:

  1. .env.development
  2. .env.production
VUE_APP_API_URL="https://jsonplaceholder.typicode.com"

在頁面中使用:

console.log(process.env.VUE_APP_API_URL);

參考官網

--

--

Jess
再不寫就要忘了

之後的文章都會搬到https://penueling.com發表囉!