根本原因是path中多个目录存在同名node/npm，系统按顺序查找时优先调用了旧版本或错误路径的二进制文件；需通过echo $path、which -a node/npm、ls -la $(which node)等命令定位冲突，统一在~/.zprofile管理path，清理残留，并推荐改用nvm彻底规避问题。
根本原因是 path 中多个目录存在同名的 node 或 npm 可执行文件，系统按顺序查找时优先调用了旧版本、错误路径或权限受限的二进制文件。这不是 node.js 没装好，而是 shell 找错了“人”。
确认冲突源头
运行以下命令快速定位问题：
-
echo $PATH—— 查看路径顺序，靠前的优先匹配 -
which -a node和which -a npm—— 列出所有可执行文件位置，对比哪个被实际调用 -
ls -la $(which node)—— 看它是不是软链接，指向哪里（例如是否还连着/usr/local/bin/node） -
brew list node—— 确认 Homebrew 是否已安装，以及安装位置（Apple Silicon 是/opt/homebrew/bin/node）
统一 PATH 管理入口
macOS GUI 应用（如 VS Code 终端、Alacritty）默认读 ~/.zprofile，而普通终端标签页常复用 ~/.zshrc。混用两者是冲突高发区。
- 把所有
export PATH=...行从~/.zshrc中删掉，只保留在~/.zprofile - 在
~/.zprofile开头或显眼位置添加（Apple Silicon 推荐写法）：export PATH="/opt/homebrew/bin:$PATH" - 如果同时用了 nvm 或手动安装路径，确保它们的
export行也在~/.zprofile，且顺序合理（例如 nvm 的$NVM_DIR/versions/...应在 Homebrew 路径之后，除非你明确想让它优先） - 保存后，新开一个终端窗口（不是新标签页），再运行
which node验证
清理残留与重置状态
旧安装残留会持续干扰，尤其当 /usr/local/bin/node 还存在时：
- 卸载 Homebrew Node（如有）：
brew uninstall node - 删除旧二进制：
sudo rm -f /usr/local/bin/node /usr/local/bin/npm /usr/local/bin/npx - 清空 shell 缓存：
hash -d（Zsh/Bash 均支持） - 检查是否被 Xcode 工具链劫持：
xcode-select --install或xcode-select --reset - 重启 Terminal.app 或从 Finder 启动一次，模拟真实 GUI 场景
更彻底的长期方案：改用 nvm
nvm 天然规避路径和权限问题。它把每个 Node 版本装在 ~/.nvm/versions/ 下，每次 nvm use 都动态更新 PATH 最前面，不依赖系统级路径顺序。
- 安装：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash - 按提示将两行初始化代码加入
~/.zprofile（不是.zshrc） - 重启终端，运行
nvm install --lts && nvm use --lts - 此后所有
npm install -g都自动落在用户目录，无需sudo，也无 EACCES 风险
