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 相关行 ,详情请查看安装指南

使用 VitePress 构建