Node.js 是近年來開發網站的主流選擇之一，主要以 JavaScript 撰寫。經過實際測試，Node.js 在處理高併發請求時的效能表現優於傳統的 LAMP 架構。本文將整理新手在環境建置時的標準步驟，協助你快速上手 Node.js 與 Express 框架。
⚡ 快速跳轉（依實務情境選擇）：
推薦安裝方式：使用 NVM 管理 Node.js 版本
在開始開發之前，強烈建議不要直接從官網下載 .msi 或 .pkg 安裝檔。雖然官網提供的 LTS（長期支援）版本相對穩定，但直接安裝會導致未來切換版本困難，且容易遇到 npm 權限問題。
為什麼不建議直接安裝？
直接透過官網下載安裝檔被視為「非推薦做法」，原因如下：
- 版本切換困難：若不同專案需要不同版本的 Node.js，直接安裝法無法快速切換。
- 權限衝突：全域安裝套件時常需要
sudo或管理員權限，容易造成開發環境混亂。
解決方案：使用 NVM
我們建議先安裝 NVM (Node Version Manager)，這是一個專門管理 Node.js 版本的工具，能讓你在一台電腦中輕鬆切換多個版本。詳細的安裝步驟請參考：NVM 教學 – 如何使用 NVM 切換 Node.js 版本。
安裝 Node.js 與版本檢查
安裝好 NVM 後，請開啟終端機 (Terminal)，輸入以下指令來安裝最新的 LTS 版本：
# 安裝最新的長期支援版本 (LTS)
nvm install --lts
# 切換至該版本
nvm use --lts確認安裝成功
安裝完成後，在終端機輸入以下指令確認版本號：
node -v只要回傳的版本號與官網標示的 LTS 版本一致，即代表環境建置完成，可以開始開發專案。
建立 Express 專案：使用 Express-Generator
Express 是 Node.js 最受歡迎的 Web 框架。為了快速產生專案結構，我們會使用官方提供的 Express-Generator 工具。
1. 安裝全域工具
在終端機執行以下指令，將產生器安裝至全域環境：
npm install -g express-generator2. 初始化專案結構
使用以下指令建立一個新的專案資料夾：
express my-project-name註：my-project-name 請替換成你的專案名稱。若不填寫，則會在當前資料夾直接產生檔案。
啟動伺服器與驗證結果
專案資料夾建立後，必須先安裝該專案所需的相依套件（Dependencies），才能正式啟動。
1. 安裝相依套件
進入專案資料夾並執行安裝指令：
cd my-project-name
npm install此指令會根據專案內的 package.json 檔案，自動下載所有必要的套件至 node_modules 資料夾。
2. 啟動伺服器
執行以下指令啟動 Node.js 伺服器：
npm start啟動成功後，開啟瀏覽器並輸入 http://localhost:3000，若看到 "Welcome to Express" 的畫面，代表你的 Node.js 與 Express 環境已成功運作。
常見問題 Q&A
Q1：執行 npm install 時出現 EACCES 權限錯誤怎麼辦？
這通常是因為你使用了官網直接安裝法，導致全域目錄需要管理員權限。
- 解法：最根本的解決方式是移除現有 Node.js 並改用 NVM 管理版本，NVM 會將套件安裝在使用者目錄下，完全避開權限問題。
Q2：瀏覽器輸入 localhost:3000 卻顯示「無法連線」？
請檢查以下三點：
- 終端機狀態：確認
npm start是否仍在執行中，且沒有報錯訊息。 - 連接埠佔用：確認是否有其他程式佔用了 3000 Port。
- 防火牆設定：若在遠端伺服器開發，請確認防火牆已開啟 3000 Port 的入站規則。
Q3：前端呼叫 Express API 時出現 CORS 錯誤？
當你的前端（如 React/Vue）與後端 Express 運行在不同連接埠時，瀏覽器會基於安全機制阻擋請求。
- 解法：請參考 CORS 錯誤是什麼？如何解決本地端跨域請求 了解如何在 Express 中配置 CORS Middleware (Middleware)。
Maya Lanter
i love this best post
米糕
謝謝~