nvm

Node.js 版本管理器

补充说明

nvm 通过 shell 函数切换 Node.js 版本，每个版本有独立的全局 npm 包。它不会自动切换目录版本，需要 .nvmrc 配合 hook 或手动 nvm use。

常用示例

nvm install 20
nvm install --lts
nvm use 20
nvm use --lts
nvm ls
nvm ls-remote
nvm current
nvm alias default 20
nvm uninstall 18
nvm exec 20 node --version
nvm which 20
nvm use            # 读取 .nvmrc

.nvmrc：

20

易错点与排错

• nvm 是 shell 函数，不是可执行文件；脚本里不能直接 nvm，要先 source 初始化脚本。
• 不要用 sudo nvm；权限会落到 root，导致目录归属混乱。
• 每个 Node 版本的全局 npm 包是独立的；切换后命令可能“消失”。
• nvm use 只影响当前 shell；新开终端要重新执行。
• 想按目录自动切换需要额外 hook（如 zsh 的 nvm 插件），nvm 本身不自动做。
• nvm alias default 决定新 shell 的默认版本；不设置会一直用当前默认。
• nvm 对 fish 等 shell 支持有限；先确认官方支持方式。
• 和系统 Node、corepack、asdf 混用时 PATH 顺序容易冲突；只保留一种管理方式。

相关命令

• node — Node.js 运行时
• corepack — 包管理器版本
• asdf / mise — 多语言版本管理