Lazy loaded image
Node.js node 版本管理
Words 1050Read Time 3 min
2025-9-29
2026-2-25
date
related_level
slug
nodejs_version
type
Post
relate_date
summary
nvm 与 nvs 安装配置,国内源设置,Node.js 版本管理
status
Published
tags
javascript
版本管理
效率神器
最新推荐
category
编程开发
last_updated
Feb 25, 2026 10:29 PM
是否已更新
orginal_page
是否推荐
 

利用 nvm 进行 Node.js 版本管理

参考资料
  • 注意和 nvm-windows 不是一个项目
安装 nvm
Mac, Linux
  • export NVM_DIR="$HOME/.nvm"
  • 下载并设置执行安装脚本
    • curl -o- "https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh" | bash
配置终端 rc 自动加载 nvm
  • 假设使用 bash shell
  • 写入 ~/.bashrc
    • cat >> ~/.bashrc << 'EOF' export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" EOF
  • 重新加载
    • source ~/.bashrc
  • 其他变量根据需要配置
通过变量 NVM_NODEJS_ORG_MIRROR 配置国内 nodejs 源地址
  • 默认源为 node,值为 https://nodejs.org/dist/
Node.js 国内源地址
  • cat >> ~/.bashrc << 'EOF' export NVM_NODEJS_ORG_MIRROR=https://mirrors.aliyun.com/nodejs-release/ EOF
  • 重新加载
    • source ~/.bashrc
  • echo $NVM_NODEJS_ORG_MIRROR
nvm 基本用法
帮助指令
  • nvs help
  • nvs help <command>
  • nvm ls-remote [filter] 显示远程源的可用 Node.js 版本
nvm install [version] 安装特定 Node.js 版本
  • nvm install lts
  • nvm install node/16
  • nvm uninstall [version] 卸载特定 Node.js 版本
  • nvm ls [filter] 显示本地已安装的 Node.js 版本
  • nvm use [version] 切换当前 Node.js 版本
    • nvm use 使用默认版本
  • nvm deactivate 从 PATH 移除 nvm 路径
设置版本别名
  • nvm alias <my_alias> [version]
  • nvm alias default [version]
    • 使用关键字 default 设置特定版本为默认使用的版本
通过 .nvmrc 文件告知 nvm 当前项目使用的默认版本
  • echo "lts/*" > .nvmrc
    • nvm use 将默认使用最近的 lts 版本
  • npx nvmrc 验证 .nvmrc 文件
安装新版本时迁移全局安装包
  • nvm install --reinstall-packages-from=<old_ver> <new_ver>
    • 只是在新版本上全部安装一遍,原本版本的包不受影响
    • 不会更新 npm 版本,如果需要更新则添加 --latest-npm
 

Windows 通过 nvm-windows 进行 Node.js 版本管理

安装 nvm-windows
  • scoop install nvm
通过命令行 nvm node_mirror 配置国内源
  • nvm node_mirror https://npmmirror.com/mirrors/node/
  • nvm node_mirror https://nodejs.org/dist/
    • 恢复默认地址
  • nvm npm_mirror https://npmmirror.com/mirrors/npm/
nvm-windows 基本用法
  • nvm [on|off] 启用或禁用 nvm 版本管理
    • 影响 PATH 环境变量
  • nvm proxy [url] 设置代理
    • nvm proxy http://127.0.0.1:1080
  • nvm root <path> 设置 node.js 的存放路径
    • nvm root G:\nvm\nodejs\
  • nvm list available 显示远程源的可用 Node.js 版本
  • nvm current 显示当前使用的版本
nvm install <version> [arch] 安装特定 Node.js 版本
  • nvm install latest
  • nvm install lts
  • nvm install 22
  • nvm uninstall <version> 卸载特定 Node.js 版本
  • nvm list 显示本地已安装的 Node.js 版本
  • nvm use [version] [arch] 切换当前 Node.js 版本
 

(可选) 利用 nvs 进行 Node.js 版本管理

参考资料
安装 nvs
Windows
Mac, Linux
  • 设置NVS_HOME变量
  • 下载并设置执行安装脚本
nvs 基本用法
  • 设置保存在$NVS_HOME/settings.json
帮助指令
  • nvs help
  • nvs help <command>
管理远程源
  • 默认源为 node,值为 https://nodejs.org/dist/
Node.js 国内源地址
  • nvs remote 查看当前远程源列表
  • nvs remote <name> 查看特定远程源的地址
    • nvs remote node
  • nvs remote <name> <uri> 更新远程源
  • nvs remote add <name> <uri> 新增远程源
  • nvs remote rm <name> 删除远程源
  • nvs ls-remote [filter] 显示远程源的可用 Node.js 版本
nvs add [version] 安装特定 Node.js 版本
  • nvs add lts 最近版本
  • nvs add node/16
  • nvs ls [filter] 显示本地已安装的 Node.js 版本
  • nvs use [version] 切换当前 Node.js 版本
    • nvs use 使用默认版本
  • nvs remote [name] [value] 设置特定版本的别名
设置或取消特定版本为默认版本
  • nvs link [version]
  • nvs unlink [version]
  • nvs upgrade [fromversion] 升级当前 Node.js 版本至最新小版本
    • 不会变更大版本
nvs auto on 开启自动切换选项
  • 根据当前文件夹下的 .nvmrc 文件指定的版本自行切换,无对应版本会自动下载
  • .nvmrc 文件则使用默认版本
  • 手动切换至 .nvmrc 文件指定的版本
    • nvs use auto
    • nvs auto
VSCode 配置 nvs
  • Configure launch.json so VS Code uses NVS to launch node version node/16.13.2/x64:
上一篇
Win 包管理 Scoop
下一篇
Node.js 包管理

Comments
Loading...