本文旨在解决在 macOS 上使用 Homebrew 安装 NVM (Node Version Manager) 后，提示已安装但 nvm 命令无法识别的问题。主要原因是缺少环境变量配置，导致 shell 无法找到 NVM 的可执行文件。本文将详细介绍如何正确配置 NVM，使其能够正常工作。
在使用 NVM 管理 Node.js 版本时，遇到安装后无法使用 nvm 命令的情况并不少见。 即使 Homebrew 提示 NVM 已经安装，但终端却显示 "command not found: nvm" 错误，这通常是因为缺少必要的环境变量配置。以下步骤将指导你如何解决这个问题。
1. 确认 NVM 是否已安装
首先，通过 Homebrew 确认 NVM 是否确实已经安装。在终端中运行以下命令：
brew list nvm
如果 NVM 已经安装，该命令会显示 NVM 的安装路径。
2. 配置 NVM 环境变量
关键步骤在于配置 NVM 的环境变量。NVM 需要添加到 shell 的配置文件中，以便 shell 能够找到 nvm 命令。
找到你的 shell 配置文件。常见的 shell 配置文件包括：
- .zshrc (Zsh)
- .bashrc (Bash)
- .bash_profile (Bash，某些系统上使用)
使用文本编辑器（如 nano、vim 或 VS Code）打开你的 shell 配置文件。例如，如果使用 Zsh，则运行：
nano ~/.zshrc
在配置文件末尾添加以下行：
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
解释:
- export NVM_DIR="$HOME/.nvm": 设置 NVM 的安装目录。
- [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh": 加载 NVM 的脚本，该脚本定义了 nvm 命令。
- [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion": 加载 bash 自动补全脚本 (如果使用 bash)。
保存文件并关闭编辑器。
3. 重新加载 Shell 配置文件
为了使配置生效，需要重新加载 shell 配置文件。在终端中运行以下命令：
source ~/.zshrc # 如果你使用的是 Zsh # 或者 source ~/.bashrc # 如果你使用的是 Bash # 或者 source ~/.bash_profile # 如果你使用的是 Bash，且使用 .bash_profile
4. 验证 NVM 是否工作
现在，尝试运行 nvm --version 命令，如果配置正确，应该会显示 NVM 的版本号。
nvm --version
如果仍然显示 "command not found: nvm" 错误，请仔细检查以上步骤，确保配置文件路径和内容正确无误。
5. 安装 Node.js 版本
一旦 NVM 正常工作，就可以使用它来安装 Node.js 版本了。例如，要安装 Node.js 16.0.0 版本，可以运行：
nvm install v16.0.0
安装完成后，使用以下命令来使用该版本：
nvm use v16.0.0
注意事项：
- 每次打开新的终端窗口，都需要重新加载 NVM 环境，或者将 nvm use 命令添加到你的 shell 配置文件中，以便自动切换到指定的 Node.js 版本。
- 如果在使用 NVM 过程中遇到其他问题，可以参考 NVM 的官方文档或搜索相关解决方案。
总结：
解决 NVM 安装后无法使用的问题的关键在于正确配置环境变量，确保 shell 能够找到 nvm 命令。通过编辑 shell 配置文件并重新加载，可以使 NVM 正常工作，从而方便地管理和切换 Node.js 版本。 仔细按照以上步骤操作，即可解决 "command not found: nvm" 错误，并开始使用 NVM 管理你的 Node.js 环境。
