用brew pin可锁定指定包（如node@16、python@3.9）使其彻底脱离自动升级流程，跳过brew outdated和brew upgrade；配合HOMEBREW_NO_AUTO_UPDATE=1和HOMEBREW_NO_INSTALL_CLEANUP=1可禁用自动更新与清理，确保旧版本长期保留。
Mac上用Homebrew管理开发环境时，经常遇到项目依赖特定版本软件（比如Node.js 16或Python 3.9），但执行brew upgrade后自动升到新版导致脚本报错、服务崩溃。这时必须让某个包彻底脱离自动升级流程，只保留手动干预权限。
用 brew pin 锁定指定软件包
这一步是核心操作，直接标记 formula 为“受保护”，使其跳过所有自动升级判断逻辑。
第一步：确认你要锁定的软件包名，必须精确到带版本号的完整名称，例如 node@16、python@3.9 或 maven（不带版本号则锁定当前链接的实例）。
第二步：运行锁定命令：brew pin node@16。注意：不能写成 node 或 node@16.20.2，【Homebrew 只认 @major.minor 格式的 formula 名】。
第三步：验证是否生效——执行 brew outdated，输出列表中不应再出现 node@16；再运行 brew list --pinned，应看到该包名列在返回结果中。
解除锁定或临时绕过锁定
当需要强制升级被锁定的包时，有两种路径可选：
方法一：先解锁再升级
执行 brew unpin node@16 → 然后 brew upgrade node@16。这会清除锁定标记，并安装该 formula 的最新 patch 版本。
方法二：跳过锁定直接升级（不改变锁定状态）
运行 brew upgrade --ignore-pinned node@16。此操作不会修改 pin 状态，升级完成后该包仍处于锁定状态，下次 brew upgrade 仍会跳过它。
注意：两种方式都会触发 Homebrew 自动将旧版本保留在 cellar 中，除非你后续执行 brew cleanup ——而如果你已设置 HOMEBREW_NO_INSTALL_CLEANUP=1，旧版本将长期保留，这对虚拟环境引用老解释器至关重要。
防止误删与增强稳定性
仅靠 pin 不足以完全守住版本底线。Homebrew 默认会在升级后自动清理旧版本，可能把你的项目正在用的 Python 实例删掉。
在终端中编辑 shell 配置文件：code ~/.zshrc（或 ~/.bashrc）。
追加两行环境变量：
export HOMEBREW_NO_AUTO_UPDATE=1export HOMEBREW_NO_INSTALL_CLEANUP=1
保存后执行 source ~/.zshrc 使配置立即生效。这两项设置能阻止每次运行 brew 命令前自动更新索引，也禁止安装新版本后自动删除旧版 keg。
这一步做完，【被 pin 的包既不会出现在 outdated 列表里，也不会被 upgrade 处理，更不会被 cleanup 清掉】，真正实现全链路防护。
