[ 從 Vue3 開始的學習筆記 #01 ] 新建一個 Vue 專案

Adrian Wang
7 min readJul 29, 2021

--

前言

Vue 在亞洲有很龐大的使用族群,眾所皆知 Vue2 到 Vue3 是一次很大的版本改動,在各方面都有卓越的提升,而且 Vue3 也完美支持 TS。

所以為了將來,也許再過幾年 React 漸漸衰弱 ( 希望不要,我真的很愛 React ) 的時候留有後路,我終於也要開始學習 Vue 了。

雖說 Vue3 在商業開發上的運用並不廣泛,大多數的公司都還是保守使用 Vue2,但 Vue2 終究是會隨著時間而被淘汰。

至於為什麼選擇從 Vue3 開始呢?我一直都是寫 React,以前也沒怎麼接觸過 Vue,所以對 Vue2 可以說是完全沒概念。因此對我來說學 Vue2 還是 Vue 3 都是一樣的 ( 一樣新 🤣 )。而且既然有新的我就想學最新的,所以我的 Vue 入門之旅就決定從 Vue3 開始啦!

這篇就只是建立新專案的步驟,沒什麼學習壓力,基本上無腦照步驟做就可以了。

如何在專案使用 Vue?

如同 React 和 Angular 一樣,我們可以使用多種方式來建立專案,例如:

  1. 在 Html 的 <script></script> 標籤中直接引入。
  2. 使用 npm 安裝 vue 並自行設置 webpack。
  3. 最方便快速也最多人用的 Vue CLI。

以下我會用 Vue CLI 來示範。

什麼是 Vue CLI?

如果你和我一樣有 React 經驗,你可以想成就是 create-react-app 的概念。或是你曾寫過的 Angular 的話,它就相當於 @angular/cli 工具。

簡單來說,Vue CLI 幫助開發者把常用到的資源都打包起來,像是 webpack、sass、eslint、hot-reload、dev-server 等環境都由 Vue CLI 幫我們建立好了,讓開發者可以快速建立一個即裝即用的專案。

在打開 Terminal 新建 Vue 專案之前,請先確認你有的電腦已經安裝過 Node 環境,這是前端之路最最最最最基本的起手式哦!

建立 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 專案 — 選擇建立方式

Vue CLI 工具會詢問你希望建立 Vue2 還是 Vue3 的專案,又或者是你想自行手動選擇版本、手動設定套件。這裡使用上下鍵控制當前選項位置,按 Enter 鍵即代表選完並繼續下一步。

我比較龜毛,我喜歡自己選擇,所以這裡我選 Manually select features 繼續設定我要的環境。

建立 Vue 專案 — 選擇版本和套件

接著會進入選擇 Vue 版本和套件的選項頁。

一樣用上下鍵控制當前選項位置,按空白鍵控制選取/不選取,按 Enter 鍵即代表選完並繼續下一步。

這部分應該不會太困難,例如你有使用 TypeScript 的話就選起來,或是習慣使用 SASS、LESS 等工具撰寫樣式那就選擇 CSS Pre-processors,根據個人開發需要選擇即可。就算真的不小心漏掉了也沒關係,到時候再手動安裝就好了。

都選好之後按下 Enter 進行下一步設置版本和套件細項。

建立 Vue 專案 — 選擇 Vue 版本

接著它會詢問我們要使用的 Vue 版本為哪一個,這邊我們選擇 3.x ( Vue 3 )。

建立 Vue 專案 — 選擇 CSS 預處理器

再來詢問我們使用的 CSS Pre-processors 工具是什麼?我習慣用 SCSS 所以我選擇 Sass/SCSS,不管你選擇 Sass/SCSS (with dart-sass)Sass/SCSS (with node-sass) 都不影響你後續的開發工作,這只是相依的套件不同而已,都可以選。

建立 Vue 專案 — 選擇 Linter

選擇欲使用的 Linter 工具。

如果你不知道這是什麼,你可以搜尋 ESLint 或 Prettier 等關鍵字,簡而言之這些是用來規範 Coding Styles,好讓程式碼的撰寫方式有一個統一性,避免每個開發者的撰寫習慣不同而使程式碼不易閱讀,進而造成維護上的困難。

一般在多人開發專案我會選擇比較嚴謹的 ESLint + Airbnb config,自己管理的小專案我會選擇 ESlint + Standard config 或是 ESlint + Prettier

沒有絕對,選一個你自己喜歡的規範就好。

建立 Vue 專案 — 選擇 Linter 規範時機

接著我們要選擇 linter 什麼時候幫我們規範程式碼,這裡有兩個選項,一是儲存檔案的時候,二是提交程式碼的時候,這裡我選擇 Lint on save

建立 Vue 專案 — 選擇工具設定檔位置

這些工具的設定檔要儲存在什麼地方?我習慣新建各自獨立的設定檔,所以這裡我選擇 In dedicated config files,你也可以選擇 In package.json 統一管理。

建立 Vue 專案 — 選擇是否儲存設定

最後,Vue CLI 工具很貼心的問說是否要把我們剛才選擇這些設定儲存起來,以便下次新建專案時可以直接使用。

輸入 y 按下 Enter 代表儲存,輸入 n 或不輸入直接按 Enter 代表不儲存。

因為我每個專案的需求不一定,所以我不會儲存。當然你也可以先保存,方便之後使用,等到有需要的時候再重新手動選擇。

不論我們有沒有儲存,Vue CLI 都會在按下 Enter 幫我們建立專案並安裝工具環境。

建立 Vue 專案 — 安裝成功

安裝成功之後我們會看這個畫面,它提示我們輸入 cd my-project 進入我們的專案資料夾,並輸入指令 yarn serve ( 或是 npm run serve ) 啟動 server。

運行專案

在我們按照指示輸入進入專案和啟動的指令以後,我們會在 Terminal 看到這個畫面。

運行專案

這代表你已經成功將專案運行在本地端,當我們使用瀏覽器進入 http://localhost:8080/ 這串網址就可以看到專案的畫面囉!

Vue 專案運行畫面

這就是我們建立的第一個 Vue 專案頁面,真的很簡單吧!

--

--

Adrian Wang
Adrian Wang

Written by Adrian Wang

Adrian 的宅宅筆記 📖 記錄前端開發及作業系統等學習筆記,偶爾也會分享我常用的生產力工具 | Github @adrianwangdev

No responses yet