Mac 怎么通过 Homebrew 安装本地下载的安装包-Mac OS-PHP中文网

homebrew不支持直接安装本地.pkg/.dmg/.zip，仅通过官方formula/cask声明式管理；可行替代方案为：1. 编写自定义cask指向本地pkg路径并提供sha256校验；2. 直接双击安装或改用brew原生安装；3. 长期维护可提交至私有tap。

homebrew 本身不支持直接安装本地下载的 .pkg、.dmg 或 .zip 安装包。它是一个面向源码或预编译二进制包（bottles）的包管理器，所有软件都必须通过其官方仓库（formula 或 cask）定义、校验、签名和分发。

但如果你手上已有本地安装包（比如 node-v20.15.0.pkg、google-chrome.dmg），又想用 Homebrew 的方式“统一管理”，有以下几种实际可行的路径：

✅ 正确理解：Homebrew 管理的是“声明式安装”，不是“拖拽式安装”

brew install node → Homebrew 自动从其仓库拉取 node formula，解析依赖（如 icu4c, openssl@3），下载预编译包（或源码编译），安装到 /opt/homebrew/Cellar/node/20.15.0，再软链到 /opt/homebrew/bin/node。
brew install --cask google-chrome → Homebrew 从 homebrew-cask 仓库读取 google-chrome.rb，里面明确写了 url "https://dl.google.com/chrome/mac/stable/GGRO/googlechrome.dmg"，然后自动下载、挂载、复制 .app 到 /Applications，并记录安装状态。

? 所以，本地已有安装包 ≠ 可被 brew 直接识别安装；Homebrew 不提供类似 brew install /path/to/local.pkg 这样的命令。

✅ 替代方案（按推荐顺序）

1. 用 `brew install --cask` + 自定义 `cask`（适合 `.pkg` / `.dmg` / `.app`）

如果你有本地 .pkg 或 .dmg，可以临时写一个轻量级 cask 文件，让 brew 指向本地路径：

# 创建临时 cask（以 chrome.dmg 为例）
echo 'cask "local-chrome" do
  version "128.0.6613.119"
  sha256 "a1b2c3..." # 请先用 shasum -a 256 chrome.dmg 计算

  pkg "/Users/you/Downloads/google-chrome.dmg"
  # 或用 pkg "/path/to/your/local.pkg"

  uninstall pkgutil: "com.google.Chrome"
end' > /tmp/local-chrome.rb

然后安装：

brew install --cask /tmp/local-chrome.rb

⚠️ 注意：

pkg 字段在 cask 中只支持 .pkg（不支持 .dmg 直接解包；若为 .dmg，需先挂载并指定 .pkg 路径，或改用 artifacts + staged 方式，较复杂）；
必须提供正确 sha256，否则校验失败；
卸载时 brew uninstall --cask local-chrome 会调用 pkgutil 清理，但仅限 .pkg 安装行为。

2. 直接双击安装，再用 `brew link`（仅限部分命令行工具，不推荐）

某些开源工具（如 wget、curl）官网也提供 .pkg。但装完后二进制通常在 /usr/local/bin/，而 Homebrew 默认装在 /opt/homebrew/bin/ —— 两者路径冲突，且 brew 无法感知该安装，后续 brew upgrade wget 会覆盖或报错。不建议混用。

3. 把本地包转成 formula/cask 提交到仓库（长期维护用）

如果你反复要用某个内部工具或定制版软件，可为其编写 formula（命令行）或 cask（GUI），然后 brew tap-new username/my-tap && brew tap-pin username/my-tap，再 brew install username/my-tap/xxx。这属于高级用法，适合团队分发。

❌ 常见误区澄清

brew install ./my-app.pkg → 语法错误，命令不存在
brew cask install ./chrome.dmg → 不支持，cask 只认 URL 或 rb 文件路径
“把 pkg 拷进 /opt/homebrew/Cellar/ 就算装好了” → 不行，缺少 checksum、link、keg 管理，brew doctor 会报错，升级卸载全部失效

✅ 更务实的建议

你手上有…	推荐做法
官网 `.pkg`（如 Node.js、VS Code）	直接双击安装，或改用 `brew install node` / `brew install --cask visual-studio-code` —— 更干净、可升级
内部 `.pkg`（公司自建安装包）	写一个本地 cask（如上），或用 `installer -pkg /path/to.pkg -target /` 手动安装
`.dmg` 里含 `.app`	直接拖进 `/Applications`，或 `brew install --cask` 已有对应项（如 `google-chrome`）
源码 `.tar.gz`	用 `brew create https://example.com/app-1.0.tar.gz` 自动生成 formula 草稿，再手动完善