nvm

• Soulock
• 2026年06月20日
• • 工具分享

NVM 环境配置与 npm 找不到的排查

macOS / Linux 上配 nvm 先确认 nvm 安装位置： echo $NVM_DIR通常是 ~/.nvm。在 ~/.zshrc（zsh）或 ~/.bashrc（bash）末尾加： export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"生效并验证： source ~/.zshrc nvm -vWindows 上配 nvm-windows 先看 nvm 目录： nvm root通常输出： C:\Users\<你>\AppData\Roaming\nvm系统环境变量里加两条： NVM_HOME = C:\Users\<你>\AppData\Roaming\nvm NVM_SYMLINK = C:\Program Files\nodejs再把 Path 里追加： %NVM_HOME% %NVM_SYMLINK%新开一个 CMD 窗口，验证： nvm version node -v npm -v常用命令速查 nvm install 22 # 装 Node 22 nvm list # 已装版本 nvm use 22 # 切换版本 nvm alias default 22 # 设默认（macOS/Linux） nvm current # 当前使用版本which node 有输出，但 npm not found 碰到这种情况： $ which node /Users/you/.nvm/versions/node/v22.21.1/bin/node$ which npm npm not found有六种可能，从概率高到低排： 1. 只装了 nvm 没装 Node nvm list # 一片空 nvm install 22 nvm use 222. 版本没激活 nvm current # 显示 none / N/A nvm use 223. PATH 没指向当前 Node echo $PATH # 看有没有 .nvm/versions/node/v22.x.x/bin4. Node 目录里 npm 文件真的没了 ls -lah /Users/you/.nvm/versions/node/v22.21.1/bin/正常应该有 node、npm、npx、corepack。只有 node 说明安装被中断过，重装： nvm uninstall 22 nvm install 225. Windows：nvm-windows 软链坏了（最常见） dir "C:\Program Files\nodejs"看到目录是空的或者链接指向失效版本，重新 nvm use： nvm use 22.19.0之后 where node / where npm 都会有结果。 6. Homebrew 装的 nvm 没加载环境 nvm use default # 或 nvm install --lts一句话总结 nvm 有问题时按这个顺序自检：nvm list → nvm current → which node / which npm → 检查 bin 目录是否完整。95% 的问题都是"没 use 版本"或"软链坏了"。