Windows Node.js 安裝與執行指南

目錄

1. 系統需求
2. 下載 Node.js
3. 安裝步驟
4. 環境變數設定
5. 驗證安裝
6. 基本使用方法
7. 常見問題解決

1. 系統需求

• Windows 7 SP1 或更新版本
• Windows Server 2008 R2 或更新版本
• x64 或 x86 處理器架構

2. 下載 Node.js

1. 前往官方網站 https://nodejs.org/
2. 選擇下載版本：
   • LTS (長期支援版本)：建議一般使用者選擇此版本
   • Current (最新版本)：包含最新功能，但可能較不穩定

3. 安裝步驟

1. 執行下載的安裝檔（.msi 檔案）
2. 點選「Next」開始安裝程序
3. 閱讀並接受授權條款
4. 選擇安裝目錄（建議使用預設路徑）
5. 選擇安裝組件：
   • Node.js runtime
   • npm package manager
   • 線上文件快捷方式
   • 新增環境變數
6. 點選「Install」開始安裝
7. 等待安裝完成後點選「Finish」

4. 環境變數設定

系統應該在安裝時自動設定環境變數，但如需手動設定：

1. 開啟系統內容（按 Win + X，選擇系統）
2. 點選「進階系統設定」
3. 選擇「環境變數」
4. 在「系統變數」中找到 Path
5. 點選「編輯」並新增：

   C:\Program Files\nodejs\

5. 驗證安裝

開啟命令提示字元（CMD）或 PowerShell，輸入以下命令：

node --version
npm --version

若顯示版本號碼，則表示安裝成功。

6. 基本使用方法

執行 JavaScript 檔案

1. 建立一個 .js 檔案，例如 hello.js：

   console.log("Hello, Node.js!");

2. 在命令提示字元中執行：

   node hello.js

使用 npm 安裝套件

# 全域安裝
npm install -g package-name

# 專案內安裝
npm install package-name

建立新專案

# 建立新目錄
mkdir my-project
cd my-project

# 初始化專案
npm init

7. 常見問題解決

node 命令無法識別

• 重新檢查環境變數設定
• 重新啟動命令提示字元
• 重新啟動電腦

npm 安裝套件失敗

• 檢查網路連線
• 清除 npm 快取：

  npm cache clean --force

• 使用管理員權限執行命令提示字元

權限問題

• 以系統管理員身份執行命令提示字元
• 檢查資料夾存取權限
• 確認使用者帳戶具有適當權限

版本衝突

• 使用 nvm-windows 管理多個 Node.js 版本
• 確認專案相依性要求
• 適時更新或降級套件版本

結語

完成以上步驟後，您的 Windows 系統已經準備好進行 Node.js 開發。若遇到任何問題，建議參考：

• Node.js 官方文件
• npm 官方文件
• Stack Overflow 社群