nvm 安装版本，切换版本，配置shell

 1.确认版本已安装

• 检查版本是否存在：

  nvm ls

  • 若目标版本未列出，需先安装：

    nvm install <版本号>

2. 正确设置默认版本

• 分两步操作：
  1. 激活版本（初始化环境变量）：

     nvm use <版本号>

  2. nvm alias default <版本号>

  • 示例：

    nvm use 18.17.1 # 激活版本

    nvm alias default 18.17.1 # 设置为默认

3. 验证默认版本

• 查看版本列表：

  nvm ls

  • 成功标志：输出中显示 default -> <版本号>（如 default -> 18.17.1）。
• 检查当前生效版本：

  node -v # 应输出默认版本号

4. 解决常见问题

问题 1：nvm alias default 后仍无默认标记

• 原因：未执行 nvm use 初始化版本，导致别名指向无效路径。
• 解决：
  1. 删除无效别名：

     nvm unalias default

  2. 重新执行步骤 2（先 use 再 alias）。

问题 2：新终端未自动加载默认版本

• 原因：Shell 未初始化 nvm 脚本。
• 解决：
  1. 检查 Shell 配置文件（如 ~/.zshrc、~/.bashrc）：

     cat ~/.zshrc | grep nvm.sh

  2. 确保包含以下内容：

     export NVM_DIR="$HOME/.nvm"

     [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # 加载 nvm

     [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # 可选：补全功能

  3. 重新加载配置：

     source ~/.zshrc # 或 source ~/.bashrc

问题 3：存在多个 Node 安装路径冲突

• 现象：which node 输出非 nvm 管理路径（如 /usr/local/bin/node）。
• 解决：
  1. 卸载冲突版本：

     brew uninstall node # 若通过 Homebrew 安装

  2. 确保 PATH 优先使用 nvm 路径：
     • 在 ~/.zshrc 顶部添加：

       export PATH="$NVM_DIR/versions/node/<版本号>/bin:$PATH"

5. 终极验证

• 重启终端，依次执行：

  nvm ls # 应显示 default -> <版本号>

  node -v # 应输出默认版本号

  which node # 应指向 ~/.nvm/versions/node/<版本号>/bin/node

总结命令表

步骤	命令
1. 检查版本是否存在	nvm ls
2. 安装缺失版本	nvm install <版本号>
3. 激活版本	nvm use <版本号>
4. 设置默认别名	nvm alias default <版本号>
5. 验证默认版本	nvm ls + node -v
6. 修复 Shell 初始化	编辑 ~/.zshrc 并 source ~/.zshrc
7. 排除路径冲突	brew uninstall node + 调整 PATH