本文最后更新于 42 天前,其中的信息可能已经有所发展或是发生改变。
💡 核心价值:
- 多版本Node自由切换
- 解决环境兼容问题
- 避免全局安装污染
- 提升团队协作效率
✨ 你将掌握:
- 全平台安装配置
- 10+核心操作命令
- 企业级最佳实践
- 疑难问题解决方案
🔌 一、环境安装配置
1.1 不同系统安装方式
系统平台 | 工具名称 | 安装命令 |
---|---|---|
macOS/Linux | nvm | curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash |
Windows | nvm-windows | exe安装包 |
1.2 验证安装成功
# 查看nvm版本
nvm --version
# 查看所有可用命令
nvm --help
🚀 二、核心操作命令
2.1 版本管理三板斧
# 安装指定版本(LTS版推荐)
nvm install 18.16.0
# 切换使用版本
nvm use 16.20.0
# 设置默认版本(新开终端生效)
nvm alias default 18.16.0
2.2 版本查询命令
# 查看已安装版本
nvm ls
# 查看远程所有LTS版本
nvm ls-remote --lts
# 查看当前使用版本
nvm current
🛠️ 三、企业级最佳实践
3.1 项目级版本控制
# 项目根目录创建.nvmrc文件
echo "18.16.0" > .nvmrc
# 自动切换项目node版本
nvm use
3.2 多版本并行方案
# 同时安装多个LTS版本
nvm install --lts=hydrogen # 18.x
nvm install --lts=iron # 20.x
# 快速切换最新LTS版
nvm use --lts
🔄 四、工作流集成
4.1 CI/CD配置示例
# GitHub Actions配置
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version-file: '.nvmrc'
4.2 Shell自动加载
# 在.zshrc/.bashrc中添加
autoload -U add-zsh-hook
load-nvmrc() {
if [[ -f .nvmrc && -r .nvmrc ]]; then
nvm use
fi
}
add-zsh-hook chpwd load-nvmrc
🚨 五、常见问题排雷
5.1 权限问题修复
bashCopy Code# 重置node_modules权限
sudo chown -R $(whoami) ~/.nvm
# 修复全局包权限
npm config set prefix ~/.npm-global
5.2 版本切换异常处理
现象 | 解决方案 |
---|---|
切换版本后命令失效 | 重新安装node对应版本 |
全局包丢失 | 使用nvm reinstall-packages |
Windows路径包含空格 | 修改nvm安装路径到纯英文目录 |
🔗 推荐资源:
📦 常用版本速查:
bashCopy Code# 最新LTS版
nvm install --lts
# 最新稳定版
nvm install node
# 历史经典版
nvm install 14.21.3