本週先依課程說明確認 Node.js 版本和專案啟動方式,再安裝並分別驗證 Node.js 與 npm;不同課程專案的要求可能不同,不要為了入門盲目追新版本。只有課程明確要求 macOS 工具或流程時,你才需要進一步評估 Mac 環境。
剛開始學 JavaScript 的學生:適合按課程要求準備 Node.js,並執行第一個練習。
已拿到前端課程專案的學生:適合先核對專案版本、依賴與啟動說明。
使用 Windows、但課程可能需要 macOS 的學生:適合先判斷作業是否真的限定 Mac。
先分清課程環境要求,再開始安裝
Node.js 是執行 JavaScript 的環境;瀏覽器則是執行及顯示網頁的地方。你在瀏覽器裡練習基本語法,不代表已經準備好執行課程提供的 Node.js 專案。Node.js 官方入門說明也將它介紹為可在瀏覽器以外執行 JavaScript 的環境;開始前可先讀官方 Node.js 入門介紹。
先依序查看課程大綱、作業說明和專案 README。把以下資訊記下來,避免安裝後才發現環境不符合要求:
- 課程或專案是否指定 Node.js 版本。
- 作業是否要安裝專案依賴,以及文件指定的安裝方法。
- 專案提供的啟動指令,和預期出現的畫面或結果。
- 作業是否要求 macOS 專用軟體、操作流程或檔案交付方式。
| 你目前的學習階段 | 先確認什麼 | 下一步怎麼做 |
|---|---|---|
| 剛開始學 JavaScript | 課程是否指定 Node.js 版本 | 有指定就按指定版本準備;未指定時再查專案文件 |
| 已取得課程專案 | README、版本要求及依賴安裝說明 | 依專案文件安裝和啟動,不套用其他專案的指令 |
| 同時進行多個專案 | 每個專案各自的版本和啟動方式 | 分開記錄要求,避免為一個專案改動另一個專案 |
| 使用 Windows 上課 | 作業是否明確要求 macOS | 一般前端練習先確認工具支援;有 macOS 限定再評估替代環境 |
按課程要求選擇 Node.js 安裝來源
如果課程已指定版本,就以課程及專案文件為優先;若沒有指定,不要只因為下載頁有較新的版本就直接選它。Node.js 的發布狀態會隨時間變動,官方發布表可用來查看版本資訊,下載時則應從Node.js 官方下載頁核對目前提供的版本與 macOS 安裝選項。
| 安裝情況 | 建議處理方式 | 需要留意的地方 |
|---|---|---|
| 課程明確指定版本 | 先確認官方下載頁或版本管理方式能否取得該版本 | 不要把最新版本當成課程預設版本 |
| 課程未指定版本,但有課程專案 | 查看 README 或 package.json 是否列出版本要求 | 以專案文件為準,不要憑印象選版本 |
| 你要維護多個專案 | 先查閱Node.js 官方版本管理說明 | 逐一確認專案的版本設定,避免全域切換影響其他作業 |
取得安裝檔時,不要使用來源不明的下載站。官方發布表會列出不同版本的發布狀態;選版本時,重點是它是否符合課程要求,而不是只看版本新舊。若你不確定課程指定版本如何對應官方發布資訊,先詢問課程提供者,再安裝。
安裝方法可能因官方提供的選項和課程環境而異,因此不要只照抄別人的操作畫面。Node.js 官方有下載與安裝 Node.js 及 npm 的說明可供核對;macOS 的終端機基本操作,可參考終端機入門說明。
安裝後分別驗證 Node.js 與 npm
npm 是用來管理及安裝 JavaScript 專案套件的工具。你可以把專案依賴理解為完成作業所需的額外程式碼套件;Node.js 負責執行程式,npm 則依照專案設定處理套件及相關指令。npm 的用途和命令可查閱npm 官方命令文件。
完成安裝後,開啟終端機並分別執行:
node -v
npm -v
node -v 用來查看終端機目前找到的 Node.js 版本;npm -v 用來查看 npm 版本。兩個指令都顯示版本資訊,代表終端機能辨識這兩項工具;但這不代表課程專案一定能執行,因為專案還可能要求特定版本、依賴或啟動方式。官方入門文件可協助你確認 Node.js 的執行方式,npm 的安裝說明則可供核對工具安裝步驟。
| 終端機結果 | 可以判斷什麼 | 接下來的檢查 |
|---|---|---|
node -v 顯示版本資訊 |
終端機能找到 Node.js | 對照課程或專案要求的版本 |
npm -v 顯示版本資訊 |
終端機能找到 npm | 查看專案要求的依賴安裝方式 |
| 專案啟動失敗 | 單靠版本指令無法定位所有原因 | 回到 README,核對版本、依賴和啟動說明 |
已取得專案時,讓專案文件決定啟動方式
拿到 JavaScript 前端課程專案後,不要直接假設每個專案都用相同資料夾、指令或依賴。先開啟 README 和課程提供的說明,再查閱 package.json:其中可能列出專案資訊、相依套件、Node.js 版本條件及 scripts 指令。npm 官方文件分別說明了package.json 欄位和npm scripts 的使用方式。
依照文件逐步核對:
- 版本條件:查看課程說明,或檢查
package.json是否有engines.node等版本條件。若不同文件寫法不一致,先詢問課程提供者。 - 依賴安裝:按專案說明選擇安裝方式;npm 的安裝命令文件可協助你理解命令用途,但不應取代專案自己的步驟。
- 啟動指令:查看
package.json的scripts欄位和 README,照課程提供的指令啟動,而非照搬其他練習的命令。 - 結果確認:依作業說明確認預期結果。若畫面或輸出不同,記下你使用的版本和指令,再對照課程文件逐項排查。
多個專案並行時,分開管理環境要求
不同課程專案可能使用不同 Node.js 版本,也可能對依賴和啟動方式有各自的安排。開始練習前,為每個專案各自整理一份簡短紀錄:課程要求、專案文件位置、版本條件、依賴安裝方法和啟動指令。這樣遇到問題時,你可以先確定是哪個專案的設定不符,而不是直接更改整台電腦的環境。
若你確實要在不同專案間切換版本,先閱讀Node.js 官方版本管理說明,再依照工具文件和課程要求決定做法。不要在尚未確認專案條件時,為了修好一份作業就改動另一個課程專案的版本或設定。
沒有 Mac 時,先判斷課程是否真的需要 macOS
Node.js 和 JavaScript 前端練習不應被預設為必須使用 Mac。若課程只要求一般 JavaScript、Node.js 或網頁練習,先看授課單位是否支援你目前的作業系統,以及課程指定工具是否能在該環境使用。
若作業明確要求 macOS 專用工具或流程,再確認可用環境是否符合課程指定的軟體、連線方式和檔案交付要求。遠端 Mac 是一種可評估的選項,但是否合用仍取決於課程條件和你的使用需求。你可以先查看遠端 Mac 的連線方式,再評估是否能完成課程需要的操作。
常見問題
Mac 上如何安裝 Node.js 和 npm?
先確認課程指定版本,再到 Node.js 官方下載頁核對 macOS 安裝選項;安裝完成後,分別用 node -v 和 npm -v 檢查終端機是否能辨識兩項工具。
安裝完成後,怎麼知道 Node.js 可以執行?
在終端機執行 node -v,查看是否顯示版本資訊。再執行 npm -v 確認 npm。這只代表指令可用,專案仍須按 README 核對版本和啟動方式。
課程專案要求不同版本時該怎麼做?
將每個專案的版本條件和啟動方式分開記錄,依課程文件處理。需要切換版本時,先參考 Node.js 官方的版本管理說明,不要未經核對就修改其他專案的環境。
沒有 Mac,能否完成 Node.js 前端課程?
先確認課程是否要求 macOS 專用工具或流程。一般 JavaScript 和 Node.js 練習不應一概視為必須用 Mac;若作業確有 macOS 限定,再核對軟體、連線和檔案交付要求。
Node.js 專案在 Mac 上怎麼啟動?
先讀 README 和課程說明,核對版本及依賴安裝步驟,再查看 package.json 的 scripts 欄位。依專案文件提供的指令啟動,不要假設所有專案使用相同命令。
依課程條件決定是否準備 Mac
如果你目前的 Windows 電腦已能執行課程指定工具,改用 Mac 未必能解決新的學習問題;先沿用現有環境,通常更容易維持課程進度。相反地,若課程明確要求 macOS,而你手邊沒有 Mac,單靠 Windows 可能無法完成指定工具或流程;購買實機也代表你要先承擔設備成本,並自行準備和維護環境。
這時可先核對課程指定軟體、連線方式和作業交付要求,再判斷是否需要遠端 macOS 環境。若你只需要在課程期間使用 Mac 完成指定操作,可以先了解 OSXBuild 的 Mac 使用方案,再按自己的課程需求評估;若課程沒有 macOS 限定,則不必為一般 Node.js 練習額外換設備。
常見問題
在 Mac 安裝 Node.js 和 npm,應從哪裡開始?
先看課程與專案文件有沒有指定 Node.js 版本,再到 Node.js 官方下載頁核對適用於 macOS 的安裝方式。完成安裝後,分別在終端機執行 node -v 與 npm -v;npm 通常會隨 Node.js 安裝,但仍要各自確認終端機能否辨識。
安裝 Node.js 後,怎麼確認它可以執行?
開啟終端機,執行 node -v 和 npm -v,確認兩個指令各自顯示版本資訊。這只代表終端機找到對應工具,並不等於課程專案已能執行;你還要依 README 核對專案版本、依賴安裝方式和啟動指令。
前端課程專案指定不同的 Node.js 版本時怎麼辦?
先把每個專案要求的版本和啟動方式分開記錄,不要為了其中一個專案直接更改另一個專案的設定。查閱 Node.js 官方版本管理說明,選擇適合管理多個版本的方法;專案若有 engines.node 或版本設定檔,也要先按專案文件核對。
沒有 Mac,也能完成 Node.js 前端課程嗎?
如果課程只要求 JavaScript、Node.js 和一般網頁練習,先確認課程工具是否支援你手邊的作業系統,通常不應預設一定要有 Mac。若作業明確要求 macOS 專用工具或流程,再核對軟體、連線和檔案交付條件,評估遠端 macOS 環境是否合用。
Node.js 專案在 Mac 上如何啟動?
不要先假設每個專案都使用相同指令。先閱讀 README 和課程說明,確認 Node.js 版本及依賴安裝方式;再查看 package.json 的 scripts 欄位,按專案提供的指令啟動。若說明未列出啟動方式,先詢問課程或專案維護者,不要任意嘗試修改設定。
