Mac上安装Heroku CLI有五种方式：一、Homebrew推荐方式；二、Shell脚本直装；三、npm全局安装；四、手动下载配置二进制；五、登录验证。每种均需验证版本或功能。

如果您希望在Mac系统上安装Heroku CLI以进行应用部署与管理，但发现常规Homebrew方式受限或需更灵活的安装路径，则需考虑多种兼容性方案。以下是满足不同环境约束的安装步骤：

一、通过Homebrew安装（推荐标准方式）

Homebrew是macOS最主流的包管理器，适用于已安装Xcode命令行工具且网络通畅的用户。该方式可自动处理依赖并便于后续更新。

1、打开终端，执行命令安装Xcode命令行工具（若未安装）：
xcode-select --install

2、安装Homebrew（如尚未安装）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3、添加Heroku官方tap并安装CLI：
brew tap heroku/brew && brew install heroku

4、验证安装结果：
heroku --version

二、使用Shell脚本直接安装（无需Homebrew）

当系统无法使用Homebrew（如权限受限、网络屏蔽或企业策略限制）时，可采用Heroku官方提供的轻量级shell安装脚本，绕过包管理器直接部署二进制文件。

1、在终端中运行以下命令下载并执行安装脚本：
curl https://cli-assets.heroku.com/install.sh | sh

2、脚本将自动将heroku二进制文件复制至/usr/local/bin/heroku，并设置可执行权限。

3、手动将/usr/local/bin加入PATH（如未自动生效）：
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

4、确认命令可用：
heroku --version

三、通过npm全局安装（适用于Node.js开发者）

若您已配置Node.js与npm环境，此方式能复用现有开发链路，尤其适合前端或全栈项目中集成CLI工具链。

1、确保Node.js版本不低于18.x：
node --version

2、执行全局安装命令：
npm install -g heroku

3、检查是否被npm bin路径正确识别：
npm bin -g

4、将输出路径（如/opt/homebrew/lib/node_modules/npm/bin）加入PATH（若未自动包含）：
echo 'export PATH="$(npm bin -g):$PATH"' >> ~/.zshrc && source ~/.zshrc

5、验证CLI可用性：
heroku --version

四、手动下载并配置二进制文件

适用于高度受限环境（如离线机器、安全沙箱），需手动获取、校验并部署官方签名二进制文件，确保完整性与可信来源。

1、访问Heroku CLI发布页获取最新Darwin ARM64或Intel版本URL：
https://github.com/heroku/cli/releases

2、使用curl下载对应压缩包（示例为ARM64架构）：
curl -L https://github.com/heroku/cli/releases/download/v10.22.0/heroku-darwin-arm64.tar.gz -o heroku.tar.gz

3、解压并提取二进制文件：
tar -xzf heroku.tar.gz && mv heroku /usr/local/bin/

4、赋予执行权限：
sudo chmod +x /usr/local/bin/heroku

5、测试基础功能：
heroku help auth

五、登录与基础验证

无论采用哪种安装方式，首次使用前均需完成身份认证，CLI将生成凭证并存储于~/.netrc中，用于后续所有API交互。

1、启动交互式登录流程：
heroku login

2、终端将提示打开浏览器并跳转至Heroku授权页面，完成OAuth确认后返回终端。

3、验证账户绑定状态：
heroku auth:whoami

4、若需非交互式登录（如CI环境），使用凭据输入模式：
heroku login -i

5、输入注册邮箱、密码及两步验证码（如启用）后，终端显示Logged in as your@email.com