MacOS系统Heroku CLI报错找不到module，卸载重装无效求助

我之前在macOS上折腾Heroku CLI时也碰到过一模一样的错误，brew卸载重装不管用的核心原因是卸载不彻底，残留的配置文件、缓存或旧安装路径干扰了新部署的CLI。试试下面这套彻底的修复流程：

Step 1: 彻底清理所有Heroku相关残留 #

brew的卸载命令只会移除主程序，不会清理用户目录下的配置和缓存，这些残留就是问题根源：

• 先终止所有可能运行的Heroku进程：

  pkill -f heroku
  

• 清理brew的Heroku残留文件：

  brew cleanup heroku
  

• 手动删除用户目录下的Heroku配置、缓存和数据文件夹：

  rm -rf ~/.heroku
  rm -rf ~/.local/share/heroku
  rm -rf ~/Library/Caches/heroku
  

• 如果你之前用过npm全局安装Heroku CLI，也要一并卸载：

  npm uninstall -g heroku
  

Step 2: 重新安装Heroku CLI #

这里推荐两种安装方式，优先试试官方脚本（比brew更不容易出现路径或依赖问题）：

方式1: 官方脚本安装 #

curl https://cli-assets.heroku.com/install.sh | sh

方式2: Brew重新安装（先更新brew） #

brew update
brew install heroku/brew/heroku

Step 3: 验证修复效果 #

这一步很关键，别跳过终端重启：

1. 完全关闭当前终端窗口，重新打开一个新的终端
2. 输出版本号验证安装成功：

   heroku --version
   

3. 运行之前报错的Heroku命令，确认“Cannot find module package.json”的提示消失

额外排查（如果以上步骤无效） #

如果还是有问题，检查环境变量PATH是否包含Heroku的安装路径：

• 查看当前PATH：

  echo $PATH
  

• 官方脚本安装的Heroku通常在/usr/local/bin/heroku，如果这个路径不在PATH里，手动添加到你的shell配置文件（zsh用户是~/.zshrc，bash用户是~/.bash_profile）：
  1. 打开配置文件：

     open ~/.zshrc
     

  2. 添加一行：

     export PATH="/usr/local/bin:$PATH"
     

  3. 保存后生效配置：

     source ~/.zshrc
     

内容的提问来源于stack exchange，提问作者kylegill