Node.js 24 怎麼在 Mac 安裝？2026 新手教程

症狀：你想跟著課程寫 JavaScript，卻不確定 Mac 有沒有裝好 Node.js。
最快解法：課程沒指定版本時，優先考慮仍處於 LTS 的 Node.js 24；依官方方式安裝，再分別檢查 Node.js、npm，最後執行一個最小程式。課程指定其他版本，就先照課程要求，不要直接升級。

這篇適合第一次在 Mac 安裝 Node.js、準備開始 JavaScript 課程的學生。
如果你使用學校管理的電腦，或有現成專案但指令無法執行，也能依照對應情況檢查。

SECTION 01安裝前先看：你應該選 Node.js 24 嗎？

Node.js 是讓電腦執行 JavaScript 程式的環境；npm 則是隨 Node.js 使用的套件管理工具，負責協助專案取得及管理所需套件。可以把 Node.js 想成課程用的工具箱，把 npm 想成整理工具和材料的管理員，兩者分工不同，不是同一個軟體。npm 官方說明

沒有課程指定版本時，為什麼可先考慮 Node.js 24？
Node.js 官方發布狀態表將 v24 列為 LTS，v26 列為 Current。入門時選擇 LTS 版本，通常更符合跟課程、維持環境一致的需求；但若老師明確要求其他版本，課程相容性應優先於「版本較新」這個理由。Node.js 官方版本狀態表

先對照課程說明、作業文件或專案的版本要求，再決定是否安裝。若專案已經存在，不要只看 Node.js 版本就判斷環境正確：還要確認 npm 是否能用，以及程式是否真的跑得起來。

SECTION 02第一次在 Mac 安裝，怎麼確認每一步都完成？

安裝步驟：從官方下載頁開始

前往 Node.js 官方下載頁，依頁面提供的 macOS 選項及指示選擇安裝方式。下載前先核對課程版本要求與你的 Mac 適用選項；若頁面提供的項目、安裝畫面和課程說明不一致，先停下來確認，不要從不明來源另找安裝檔。

安裝完成後，開啟「終端機」。終端機是以文字輸入指令的操作介面，可以想成直接對工具箱下達操作要求的地方。輸入：

node -v
npm -v

這是兩項分開的檢查：第一個指令要求 Node.js 回報版本，第二個則檢查 npm 版本。若兩個指令都回傳版本字串，表示終端機能找到各自的指令；但仍須與課程要求比對，才能確認版本符合專案需要。npm 有自己的版本資訊，不能因為 Node.js 顯示版本就推定 npm 也已正常運作。npm 版本說明

建立最小程式，驗收執行結果

在方便找到的位置建立一個資料夾，作為這次練習的「作業檔案夾」。在裡面新增 hello.js，輸入：

console.log('Node.js ready');

在終端機切換到該資料夾後執行：

node hello.js

Node.js 官方文件也以終端機執行 JavaScript 檔案作為基本用法示例；這裡的驗收重點是，你看到輸出 Node.js ready，而不是只確認安裝程式曾經執行過。Node.js 官方執行示例

如果輸出內容和預期不同，先確認指令所在資料夾是否包含 hello.js，以及檔名有沒有打錯；暫時不要先修改系統路徑或移除其他開發工具。

SECTION 03已經有課程專案，為什麼 node 或 npm 不能用？

先看終端機實際回應，而不是立刻重裝。不同狀況要分開處理，因為「尚未安裝」、「目前終端機找不到指令」和「專案不符合指定版本」並不是同一個問題。

安裝後終端機仍找不到 node，該怎麼檢查？
先關閉目前的終端機視窗，再開啟新視窗並重新執行 node -v、npm -v。這是低風險的初步檢查，因為新開的終端機會重新載入目前的操作環境。若仍顯示找不到指令，回到官方下載頁核對安裝方式和步驟；不要在不了解用途時自行改動路徑或刪除系統檔案。Node.js 官方下載與安裝資料

若 Node.js 有版本輸出、npm 卻不能執行，請把兩個結果分開記錄，再檢查安裝方式是否符合官方指示。若你不確定如何修復，先保留錯誤訊息並詢問課程助教或管理員，不要複製網路上的不明修復指令。

指令能執行，但版本不符合課程要求，算安裝成功嗎？
只能說指令可用，不能直接判定課程環境正確。先查看課程說明與專案文件；若要求不清楚，向老師或助教確認。需要測試其他版本時，應先在不影響現有作業的獨立環境中驗證，不要直接改動正在使用的課程環境。

SECTION 04用 VS Code 寫程式時，怎樣驗收第一個練習？

VS Code 負責編輯程式碼，Node.js 負責執行 JavaScript；安裝編輯器不代表 Node.js 已經可用，反過來亦然。VS Code 官方提供 macOS 安裝說明，也整理了額外元件的用途；你可以按課程需要安裝編輯器，不必為了執行最小範例先安裝一大批延伸模組。VS Code macOS 安裝說明 VS Code 元件說明

Node.js 安裝後怎麼用 VS Code 跑第一個 JavaScript 程式？
先用 VS Code 開啟剛才建立的作業資料夾，再確認其中看得到 hello.js。接著在 VS Code 開啟終端機，輸入 node hello.js。如果終端機顯示 Node.js ready，而且你確認目前開啟的檔案就在這個資料夾，代表編輯位置與執行位置一致。

如果你在外部終端機執行成功、在 VS Code 終端機卻找不到 node，先關閉並重新開啟 VS Code，再檢查指令。不要立即重裝編輯器；兩個終端機可能載入環境的時間不同，應先確認各自回報的錯誤，再決定是否需要請人協助。

SECTION 05學校電腦受限時的合規選擇

學校電腦常見的限制不只是不允許安裝：管理政策可能封鎖安裝權限、終端機存取也可能受限，作業檔案還可能存放在校方指定位置。不要嘗試繞過管制或擅自修改受保護設定；先詢問老師、助教或資訊管理人員，確認課程允許的做法。

如果本機無法安裝，可以按課程規定選擇學校提供的開發環境、瀏覽器練習，或獲准使用的遠端 Mac。使用遠端環境時要特別確認三件事：課程檔案是否在遠端那台機器上、終端機是否也是遠端環境開啟的，以及執行指令時目前所在的資料夾是否正確。檔案在本機、指令卻在遠端執行，兩邊看起來都正常，實際上仍可能找不到同一份作業。

想先了解遠端 Mac 是否適合你的課程，可以從 MACNOX 的 Mac 遠端使用資訊開始，再按課程要求評估；如果你需要比較租用安排，可查看 MACNOX 的方案資訊。這類方式適合暫時需要 macOS、而本機又無法使用的情況；若你長期大量使用、需要實體連接埠，或課程要求固定的本機設備，借用或自行準備合適的電腦可能更直接。

怎麼確認遠端 Mac 上的 Node.js 和專案真的在同一個環境？
在遠端 Mac 的終端機執行版本檢查，再於同一台機器開啟專案資料夾、執行最小程式。不要只在本機 VS Code 開啟檔案，卻把命令送到遠端終端機；先確認檔案位置、終端機連線對象與目前資料夾一致，再開始跟課程操作。

如果課程要求 macOS，而你手邊的電腦暫時無法安裝或執行 Node.js，先按課程規則確認可用環境；需要短期使用 Mac 時，再評估 MACNOX 遠端 Mac 是否符合你的作業方式。若課程可在現有電腦完成，就沒有必要為了入門練習額外租用。