nvm-sh常见问题(FAQ)
Linux/macOS 版本
在 ~/.bashrc 或 ~/.zshrc 中添加:
bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
我安装了 NVM,但 nvm
命令不起作用
这可能是由几个原因导致的:
- 环境变量未正确设置:确保 NVM 的目录已添加到您的 PATH 中
- 需要重启终端:安装后,关闭并重新打开您的终端或命令提示符
- 配置文件未更新:检查您的 bash 配置文件(
.bashrc
、.bash_profile
、.zshrc
等)是否包含 NVM 初始化代码
使用问题
每次打开新终端,Node.js 版本都变回默认版本
这是因为 NVM 在每次新终端会话中默认加载默认版本。要解决这个问题,您可以:
设置默认 Node.js 版本:
bashnvm alias default 14.17.0
在项目目录中创建
.nvmrc
文件,并在项目目录中运行nvm use
全局安装的包在切换 Node.js 版本后消失了
这是 NVM 的正常行为。每个 Node.js 版本有自己独立的全局包集合。当您切换版本时,只能访问当前版本安装的全局包。
解决方案包括:
- 在每个需要的 Node.js 版本中单独安装全局包
- 使用
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 install
或 yarn 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
- 删除 NVM 目录:
rm -rf "$NVM_DIR"
- 从 shell 配置文件(
.bashrc
、.bash_profile
、.zshrc
等)中移除 NVM 相关行 ,详情请查看安装指南