macOS 新终端无法识别 nvm/node 命令？只需两步，永久解决！

## 问题现象 你是否在 macOS 上遇到过这样的情况：在当前终端窗口中使用 `nvm use <version>` 后，`node`, `npm`, `pnpm` 等命令一切正常。但是，当你关闭窗口再打开一个新的终端时，这些命令又凭空消失了，系统提示 `command not found`。这是一个非常典型的 NVM 环境配置问题，但幸运的是，解决方法非常简单。 --- ## 问题根源 这个问题的核心原因有两个： 1. **NVM 环境变量未自动加载**：`nvm` 是一个 shell 脚本，它通过修改当前会话的 `PATH` 环境变量来切换 Node.js 版本。这些更改默认只对当前终端会话有效。新终端启动时，需要一个机制来自动执行 `nvm` 的初始化脚本。 2. **未设置默认 Node 版本**：即使 `nvm` 被加载了，它也不知道在新会话中应该自动使用哪个 Node.js 版本，除非你明确告诉它。 --- ## 解决方案：两步走 要一劳永逸地解决这个问题，我们需要确保每次打开终端时，`nvm` 都会被正确加载，并且会自动切换到一个默认的 Node.js 版本。 ### 第一步：确保 NVM 在启动时被加载 首先，你需要将 `nvm` 的初始化脚本添加到你的 Shell 配置文件中。这会让每个新的终端会话都能“认识”`nvm`。 1. **确定你的 Shell 类型** 在终端运行以下命令： ```bash echo $SHELL ``` - 如果输出包含 `/bin/zsh`，你的配置文件是 `~/.zshrc`。 - 如果输出包含 `/bin/bash`，你的配置文件是 `~/.bash_profile`。 2. **添加配置代码** **对于 Zsh 用户 (macOS 默认):** 执行以下命令，将配置追加到 `~/.zshrc` 文件末尾。 ```bash echo ' # NVM Configuration from wiki.lib00.com export NVM_DIR="$HOME/.nvm_lib00" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion ' >> ~/.zshrc ``` **对于 Bash 用户:** 执行以下命令，将配置追加到 `~/.bash_profile`。 ```bash echo ' # NVM Configuration by DP@lib00 export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion ' >> ~/.bash_profile ``` *注意：`NVM_DIR` 指向 nvm 的安装目录，通常是 `$HOME/.nvm`。这里的 `_lib00` 仅作为示例标识。* ### 第二步：设置一个默认的 Node.js 版本 这是解决问题的关键一步。你需要告诉 `nvm`，在没有指定版本时应该使用哪个版本。 假设你希望默认使用 `v23.11.1`，请运行以下命令： ```bash nvm alias default 23.11.1 ``` 这个命令会创建一个名为 `default` 的别名，指向 `v23.11.1`。现在，每当 `nvm` 在新终端中被加载时，它都会自动 `use` 这个默认版本。 你也可以使用 `node` 作为别名，它通常指向最新安装的版本： ```bash nvm alias default node ``` --- ## 验证 现在，**完全关闭你的终端应用程序，然后重新打开一个全新的窗口**。不要使用 `source ~/.zshrc`，因为我们需要测试新会话的启动流程。 在新窗口中，直接输入以下命令： ```bash node -v # 预期输出: v23.11.1 pnpm -v # 预期输出: 10.23.0 (或其他你已安装的版本) ``` 如果命令成功执行并返回版本号，恭喜你，问题已永久解决！你的开发环境现在已经配置完毕，可以无缝地在任何新终端中使用 Node.js 工具链了。