📦 NVS Node.js Version Manager — NVS Node.js Version 管理器

NVS Node.js Version Manager NVS（Node Version Switcher）是一款跨平台工具，用于管理多个 Node.js 版本。它让你轻松安装、切换并管理不同 Node.js 版本及其关联的 npm 包。

快速开始 检查 NVS 是否已安装 nvs --version

若未安装，先安装 Windows（PowerShell 或 Command Prompt） # 使用 winget（Windows 11+） winget install jasongin.nvs # 或使用 chocolatey choco install nvs # 手动安装 $env:NVS_HOME="$env:LOCALAPPDATA\nvs" git clone https://github.com/jasongin/nvs "$env:NVS_HOME" . "$env:NVS_HOME\nvs.ps1" install

Mac/Linux export NVS_HOME="$HOME/.nvs" git clone https://github.com/jasongin/nvs "$NVS_HOME" . "$NVS_HOME/nvs.sh" install

基本命令 安装 Node.js 版本 # 安装最新版 nvs add latest # 安装最新 LTS 版 nvs add lts # 安装指定版本 nvs add 18.20.0 # 安装指定架构 nvs add 18.20.0/x64

切换版本 # 当前 shell 使用某版本 nvs use 18.20.0 # 使用 LTS 版本 nvs use lts # 设为默认版本（永久） nvs link 18.20.0 # 移除默认链接 nvs unlink 18.20.0

列出版本 # 本地已安装 nvs ls # 远程可用 nvs ls-remote # 过滤远程版本 nvs ls-remote 18 nvs ls-remote lts

移除版本 nvs rm 16.20.0

高级功能 自动版本切换 基于 .node-version 或 .nvmrc 文件自动切换： # 开启自动切换 nvs auto on # 关闭自动切换 nvs auto off # 手动触发当前目录 nvs auto

版本别名 # 创建别名 nvs alias myproject 18.20.0 # 列出所有别名 nvs alias # 删除别名 nvs alias myproject

用指定版本运行命令 # 用指定版本运行脚本 nvs run 18.20.0 app.js # 用指定版本执行命令 nvs exec 18.20.0 npm test

迁移全局包 # 将全局 npm 包从旧版本迁移到新版本 nvs migrate 16.20.0 18.20.0

远程配置 # 列出已配置远程 nvs remote # 添加自定义远程（如 nightly） nvs remote add nightly https://nodejs.org/download/nightly/ # 使用自定义远程 nvs add nightly/18

常见工作流 项目初始化流程 检查项目是否存在 .node-version 或 .nvmrc 文件 若未安装 NVS，先安装 安装所需 Node.js 版本 按需开启自动切换 验证当前版本正确

版本升级流程 查看当前版本：nvs ls 安装新版本：nvs add latest 用新版本测试：nvs use latest 如需，迁移全局包：nvs migrate 满意后设为默认：nvs link latest

故障排查 若找不到 nvs 命令，确认 NVS 已正确安装并重启 shell 检查 NVS_HOME 环境变量是否指向正确目录 用 nvs which 验证版本路径 Mac/Linux 权限问题，检查 NVS 安装目录权限

环境变量 NVS_HOME：NVS 存储 Node.js 版本的目录（默认：Mac/Linux 为 ~/.nvs，Windows 为 %LOCALAPPDATA%\nvs） NVS_NODE_HOME：Node.js 安装的替代位置

与 VS Code 集成 NVS 可与 Visual Studio Code 集成，使用指定 Node.js 版本调试。在 .vscode/launch.json 配置： { "runtimeArgs": ["18.20.0"], "windows": { "runtimeExecutable": "nvs.cmd" }, "osx": { "runtimeExecutable": "nvs" }, "linux": { "runtimeExecutable": "nvs" } }