macOS 彻底卸载和重装 Node.js 指南

彻底卸载 Node.js

卸载步骤

# 1. 卸载 npm
sudo npm uninstall npm -g

# 2. 删除 Node.js 核心文件和配置
sudo rm -rf /usr/local/lib/node /usr/local/lib/node_modules /var/db/receipts/org.nodejs.*
sudo rm -rf /usr/local/include/node /Users/$USER/.npm

# 3. 删除命令和文档
sudo rm /usr/local/bin/node
sudo rm /usr/local/share/man/man1/node.1
sudo rm /usr/local/lib/dtrace/node.d

# 4. 验证卸载（应显示 command not found）
node -v
npm -v

额外清理（如适用）

Homebrew 安装：brew uninstall node

nvm 安装：删除 ~/.nvm 目录

重新安装 Node.js

方式一：官方安装包（简单）

访问 Node.js 官网

下载 macOS LTS 版本 .pkg 安装包

运行安装程序完成安装

方式二：使用 nvm（推荐开发者）

# 1. 安装 nvm
brew install nvm

# 2. 配置 nvm（添加到 ~/.zshrc）
echo 'source $(brew --prefix nvm)/nvm.sh' >> ~/.zshrc

# 3. 重新加载配置
source ~/.zshrc

# 4. 安装 Node.js LTS 版本
nvm install --lts
nvm use --lts

验证安装

node -v    # 应显示版本号
npm -v     # 应显示版本号

使用 nvm 管理多版本

nvm ls-remote          # 查看所有可用版本
nvm install 18.18.0    # 安装特定版本
nvm use 18.18.0        # 切换到指定版本
nvm ls                 # 查看已安装版本