Skip to content

nvm-sh常見問題(FAQ)

Linux/macOS 版本

在 ~/.bashrc 或 ~/.zshrc 中添加:

bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

我安裝了 NVM,但 nvm 命令不起作用

這可能是由幾個原因導致的:

  1. 環境變量未正確設置:確保 NVM 的目錄已添加到您的 PATH 中
  2. 需要重啟終端:安裝後,關閉並重新打開您的終端或命令提示符
  3. 配置文件未更新:檢查您的 bash 配置文件(.bashrc.bash_profile.zshrc 等)是否包含 NVM 初始化代碼

使用問題

每次打開新終端,Node.js 版本都變回默認版本

這是因為 NVM 在每次新終端會話中默認加載默認版本。要解決這個問題,您可以:

  1. 設置默認 Node.js 版本:

    bash
    nvm alias default 14.17.0
  2. 在項目目錄中創建 .nvmrc 文件,並在項目目錄中運行 nvm use

全局安裝的包在切換 Node.js 版本後消失了

這是 NVM 的正常行為。每個 Node.js 版本有自己獨立的全局包集合。當您切換版本時,只能訪問當前版本安裝的全局包。

解決方案包括:

  1. 在每個需要的 Node.js 版本中單獨安裝全局包
  2. 使用 nvm reinstall-packages 命令將包從一個版本復制到另一個版本

使用 nvm install 時出現 SSL 錯誤

如果您遇到 SSL 證書問題,可以嘗試以下方法:

bash
# Windows
nvm install 14.17.0 --insecure

# Linux/macOS
NVM_NODEJS_ORG_MIRROR=http://nodejs.org/dist nvm install 14.17.0

MacOS安裝node版本報錯

你遇到的是 Node.js 模塊編譯錯誤,通常發生在執行 npm installyarn install 時。具體錯誤信息:

bash
# 報錯:
/,nym/,cache/src/node-y14.18.0/files/out/Release/obj.target/v8 zlib/deps/v8/third party/zlib/zutil.o] Error 1
make[1]: *** [/Users/.../zutil.o] Error 1

這表明在編譯 Node.js 模塊依賴的 V8 JavaScript 引擎的 zlib 庫時失敗。

解決方法:

bash
# 安裝 Xcode Command Line Tools
xcode-select --install

# 安裝 Homebrew(如果未安裝)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安裝 Python(建議使用 Python 3)
brew install python

如何卸載 NVM?

Linux/macOS

  1. 刪除 NVM 目錄:rm -rf "$NVM_DIR"
  2. 從 shell 配置文件(.bashrc.bash_profile.zshrc 等)中移除 NVM 相關行 ,詳情請查看安裝指南

NVM - Node.js版本管理工具,NVM中文網由www.nvmnode.com整理維護