技能介绍

要解决什么问题

多项目并行时，各仓库往往锁定不同的 Node 版本：有的仍写在 .nvmrc，有的用 .node-version。若只靠系统全局安装的单一 node，很容易出现「本地能跑、CI 或同事机器报错」的版本漂移。NVS（Node Version Switcher）是跨平台的 Node 版本管理工具；本技能把常用检查、安装、切换与排错流程整理成可跟做的指引，减少在 shell 与项目根目录之间反复试错。

技能如何帮你操作

技能覆盖从环境自检到日常命令的完整链路：

版本生命周期：用 nvs add 安装指定或 latest 版本，用 nvs use / nvs link 切换或设为默认，用 nvs ls 查看已装版本，用 nvs remove 清理。
按项目自动切换：在项目根启用对 .node-version 或 .nvmrc 的识别后，进入目录即可对齐项目要求的 Node，无需每次手动 use。
别名与一次性执行：可为常用版本设别名；也可用特定版本运行单条命令，避免污染当前 shell 的默认版本。
升级与迁移：升级流程里可先 nvs add latest 再 nvs use 验证；满意后用 nvs migrate 把全局 npm 包迁到新版本，最后用 nvs link 固定默认。
排错与环境变量：nvs 找不到时检查安装与 shell 重启；用 nvs which 核对实际 node 路径；NVS_HOME、NVS_NODE_HOME 指向错误是常见根因。技能还提到与 VS Code 调试时在 .vscode/launch.json 中绑定对应 Node 版本。

适用边界与注意点

本技能是操作与流程说明，不会替你执行 nvs 命令；Windows 与 Mac/Linux 的安装路径与权限问题需按平台分开处理。若团队已统一使用 nvm、fnm 等其它版本管理器，应评估是否与 NVS 并存；同一台机器上多套工具混用时，以 which node 和 nvs which 为准确认当前生效的二进制。远程配置等高级能力依赖你本地的 NVS 版本与网络环境，行为以官方 NVS 文档为准。