Homebrew通过brew pin命令可锁定指定软件包（如python@3.9、node、maven）使其免于自动升级，brew list --pinned查看锁定列表，brew unpin解除锁定；锁定后该包不参与brew outdated和brew upgrade，但仍支持手动强制升级，配合HOMEBREW_NO_AUTO_UPDATE=1等环境变量可进一步增强稳定性。
Homebrew 默认会在 brew upgrade 或 brew update && brew upgrade 时一并升级所有可更新的软件包，但你可以精准控制——只锁住个别关键包（比如 Python、Node.js、Maven），让它们保持当前版本不动，其他包照常升级。
用 pin 锁定指定软件包
Homebrew 提供了内置的 pin 机制，本质是标记某个 formula 为“受保护”，使其跳过自动升级流程。操作简单且立即生效：
-
锁定一个包：例如固定当前安装的 Python 版本：
brew pin python@3.9 -
查看哪些包已被锁定：
brew list --pinned -
解除锁定（恢复可升级状态）：
brew unpin python@3.9
锁定后的行为表现
被 pin 的包不会出现在 brew outdated 列表中，也不会被 brew upgrade 处理，即使它已有新版本发布。但你仍可手动强制升级：brew upgrade python@3.9 —— 这会先自动 unpin，再执行升级。
注意：pin 只作用于 formula 名称（含版本号后缀），不支持通配符或模糊匹配；若安装的是 python（无版本后缀），则锁定的是当前链接到 /usr/local/bin/python 的那个版本，通常对应 python@3.x。
配合环境变量更稳妥
仅靠 pin 能防升级，但无法阻止 Homebrew 自动清理旧版本——而清理可能误删你虚拟环境依赖的老 Python 实例。建议同步禁用自动清理：
- 在
~/.zshrc或~/.bashrc中添加：export HOMEBREW_NO_AUTO_UPDATE=1export HOMEBREW_NO_INSTALL_CLEANUP=1 - 然后运行：
source ~/.zshrc（或对应配置文件）
这样既避免每次运行 brew 都卡在更新源，也防止 brew cleanup 擅自删除被虚拟环境引用的老版本。
验证是否生效
执行以下命令确认锁定与防护机制协同工作：
-
brew outdated—— 输出中不应出现已pin的包名 -
brew upgrade—— 日志里不会显示该包的下载或安装动作 -
brew cleanup --dry-run—— 查看将被删除的旧版本列表，确认你依赖的老版本不在其中
