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 自动从其仓库拉取nodeformula，解析依赖（如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 草稿，再手动完善 |
Homebrew 的价值在于可重复、可验证、可协同。本地包绕过仓库机制，就失去了这些优势。真有特殊需求，优先走 cask 自定义路径，而不是强行“塞进 brew”。
不复杂但容易忽略：Homebrew 管理的是“怎么装”，不是“拿什么装”。
