[ 從 Vue3 開始的學習筆記 #01 ] 新建一個 Vue 專案
前言
Vue 在亞洲有很龐大的使用族群,眾所皆知 Vue2 到 Vue3 是一次很大的版本改動,在各方面都有卓越的提升,而且 Vue3 也完美支持 TS。
所以為了將來,也許再過幾年 React 漸漸衰弱 ( 希望不要,我真的很愛 React ) 的時候留有後路,我終於也要開始學習 Vue 了。
雖說 Vue3 在商業開發上的運用並不廣泛,大多數的公司都還是保守使用 Vue2,但 Vue2 終究是會隨著時間而被淘汰。
至於為什麼選擇從 Vue3 開始呢?我一直都是寫 React,以前也沒怎麼接觸過 Vue,所以對 Vue2 可以說是完全沒概念。因此對我來說學 Vue2 還是 Vue 3 都是一樣的 ( 一樣新 🤣 )。而且既然有新的我就想學最新的,所以我的 Vue 入門之旅就決定從 Vue3 開始啦!
這篇就只是建立新專案的步驟,沒什麼學習壓力,基本上無腦照步驟做就可以了。
如何在專案使用 Vue?
如同 React 和 Angular 一樣,我們可以使用多種方式來建立專案,例如:
- 在 Html 的 <script></script> 標籤中直接引入。
- 使用 npm 安裝 vue 並自行設置 webpack。
- 最方便快速也最多人用的 Vue CLI。
—
以下我會用 Vue CLI 來示範。
建立 Vue 專案
我們可以使用 npx 新建專案,也可以先安裝 vue-cli 環境再使用 vue 指令新建專案。
兩個方式我都會介紹,以上兩個做法都可以建立 Vue 專案,只需要選一個做就可以了。
💡 以下兩種做法都可以建立 Vue 專案,你只需要選一個做就可以了。
首先打開 Terminal 準備輸入指令。
—
方法 1:使用 npx 建立專案
npx @vue/cli create my-project
方法 2–1:全域安裝 vue-cli 環境並建立專案
npm install -g @vue/cli
方法 2–2:建立 Vue 專案
vue create my-project
後面 my-project
的部分代表你要新建的專案名稱,在你輸入完指令並按下 Enter 之後,你會看到這樣的畫面:
Vue CLI 工具會詢問你希望建立 Vue2 還是 Vue3 的專案,又或者是你想自行手動選擇版本、手動設定套件。這裡使用上下鍵控制當前選項位置,按 Enter 鍵即代表選完並繼續下一步。
我比較龜毛,我喜歡自己選擇,所以這裡我選 Manually select features
繼續設定我要的環境。
—
接著會進入選擇 Vue 版本和套件的選項頁。
一樣用上下鍵控制當前選項位置,按空白鍵控制選取/不選取,按 Enter 鍵即代表選完並繼續下一步。
這部分應該不會太困難,例如你有使用 TypeScript
的話就選起來,或是習慣使用 SASS、LESS 等工具撰寫樣式那就選擇 CSS Pre-processors
,根據個人開發需要選擇即可。就算真的不小心漏掉了也沒關係,到時候再手動安裝就好了。
都選好之後按下 Enter 進行下一步設置版本和套件細項。
—
接著它會詢問我們要使用的 Vue 版本為哪一個,這邊我們選擇 3.x
( Vue 3 )。
—
再來詢問我們使用的 CSS Pre-processors 工具是什麼?我習慣用 SCSS 所以我選擇 Sass/SCSS,不管你選擇 Sass/SCSS (with dart-sass)
或 Sass/SCSS (with node-sass)
都不影響你後續的開發工作,這只是相依的套件不同而已,都可以選。
—
選擇欲使用的 Linter 工具。
如果你不知道這是什麼,你可以搜尋 ESLint 或 Prettier 等關鍵字,簡而言之這些是用來規範 Coding Styles,好讓程式碼的撰寫方式有一個統一性,避免每個開發者的撰寫習慣不同而使程式碼不易閱讀,進而造成維護上的困難。
一般在多人開發專案我會選擇比較嚴謹的 ESLint + Airbnb config
,自己管理的小專案我會選擇 ESlint + Standard config
或是 ESlint + Prettier
。
沒有絕對,選一個你自己喜歡的規範就好。
—
接著我們要選擇 linter 什麼時候幫我們規範程式碼,這裡有兩個選項,一是儲存檔案的時候,二是提交程式碼的時候,這裡我選擇 Lint on save
。
—
這些工具的設定檔要儲存在什麼地方?我習慣新建各自獨立的設定檔,所以這裡我選擇 In dedicated config files
,你也可以選擇 In package.json
統一管理。
—
最後,Vue CLI 工具很貼心的問說是否要把我們剛才選擇這些設定儲存起來,以便下次新建專案時可以直接使用。
輸入 y 按下 Enter 代表儲存,輸入 n 或不輸入直接按 Enter 代表不儲存。
因為我每個專案的需求不一定,所以我不會儲存。當然你也可以先保存,方便之後使用,等到有需要的時候再重新手動選擇。
不論我們有沒有儲存,Vue CLI 都會在按下 Enter 幫我們建立專案並安裝工具環境。
—
安裝成功之後我們會看這個畫面,它提示我們輸入 cd my-project
進入我們的專案資料夾,並輸入指令 yarn serve
( 或是 npm run serve
) 啟動 server。
運行專案
在我們按照指示輸入進入專案和啟動的指令以後,我們會在 Terminal 看到這個畫面。
這代表你已經成功將專案運行在本地端,當我們使用瀏覽器進入 http://localhost:8080/ 這串網址就可以看到專案的畫面囉!
—
這就是我們建立的第一個 Vue 專案頁面,真的很簡單吧!