適用于macOS 10.15及以上版本。

前提條件

• macOS版本：確保系統為macOS 10.15（Catalina）或更高版本。可在“蘋果菜單 > 關于本機”查看。
• 管理員權限：部分安裝可能需要管理員權限。
• 網絡連接：需要聯網下載安裝包或工具。

安裝方法

以下是三種常用的安裝Node.js方法，按推薦順序排列：

方法 1：使用Homebrew（推薦）

Homebrew 是Mac上常用的包管理器，安裝簡單且便于管理版本。

1. 安裝Homebrew（若未安裝）：

   • 打開終端（位于“應用程序 > 實用工具 > 終端”）。
   • 運行以下命令安裝Homebrew：

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
     

   • 按提示輸入密碼并回車，安裝過程可能需要幾分鐘。
   • 安裝完成后，配置Homebrew環境變量（根據提示添加至 ~/.zshrc 或 ~/.bashrc）：

     echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
     source ~/.zshrc
     

2. 安裝Node.js：

   • 在終端運行：

     brew install node
     

   • Homebrew會自動安裝最新LTS版本的Node.js和npm。

3. 驗證安裝：

   • 檢查Node.js版本：

     node --version
     

   • 檢查npm版本：

     npm --version
     

   • 輸出類似 v18.x.x（Node.js）和 9.x.x（npm）表示安裝成功。

方法 2：直接從Node.js官網下載

適合不想使用包管理器的用戶。

1. 訪問Node.js官網：

   • 打開瀏覽器，前往 nodejs.org。
   • 推薦下載 LTS版本（長期支持版，穩定），點擊“LTS”按鈕下載 .pkg 安裝包。

2. 運行安裝包：

   • 雙擊下載的 .pkg 文件，啟動安裝向導。
   • 按提示點擊“繼續”，同意許可協議，選擇安裝位置（默認即可），輸入管理員密碼完成安裝。
   • 安裝程序會自動安裝Node.js和npm。

3. 驗證安裝：

   • 打開終端，運行：

     node --version
     npm --version
     

   • 確認版本號輸出。

方法 3：使用nvm（Node Version Manager）

適合需要管理多個Node.js版本的開發者。

1. 安裝nvm：

   • 在終端運行以下命令安裝nvm：

     curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
     

   • 安裝完成后，關閉并重新打開終端，或運行：

     source ~/.zshrc
     

   • 驗證nvm安裝：

     nvm --version
     

2. 安裝Node.js：

   • 安裝最新LTS版本：

     nvm install --lts
     

   • 或指定版本，例如：

     nvm install 18
     

   • 設置默認版本：

     nvm use --lts
     nvm alias default --lts
     

3. 驗證安裝：

   • 檢查Node.js和npm版本：

     node --version
     npm --version
     

注意事項

• 權限問題：
  • 若npm安裝全局包時提示權限錯誤，避免使用 sudo。可修復npm權限：

    sudo chown -R $(whoami):admin ~/node_modules /usr/local/lib/node_modules
    

  • 或使用nvm管理Node.js，避免權限問題。
• 更新Node.js：
  • Homebrew：運行 brew upgrade node。
  • nvm：運行 nvm install --lts --reinstall-packages-from=current。
  • 官網安裝：重新下載最新 .pkg 安裝。
• 卸載Node.js（如需要）：
  • Homebrew：brew uninstall node。
  • 官網安裝：手動刪除 /usr/local/bin/node 和 /usr/local/lib/node_modules。
  • nvm：nvm uninstall <版本號>。
• 防火墻/代理：若下載緩慢，檢查網絡設置或使用國內鏡像（如 https://npmmirror.com/mirrors/node/）。

問題排查

• 命令未找到：確保環境變量正確配置，檢查 ~/.zshrc 或 ~/.bashrc 中的PATH設置。
• 安裝失敗：嘗試更新Homebrew（brew update）或清理緩存（brew cleanup）。
• 版本沖突：使用nvm管理多個版本，避免沖突。
• 若需進一步幫助，請提供錯誤信息，我可協助排查。