Homebrew 已移除 brew switch 命令，应使用 unlink + link 切换默认版本，或通过 PATH 前置、bin 脚本实现项目级隔离，也可选用 fnm/jenv/pyenv 等专业版本管理工具。
Homebrew 没有可用的 brew switch 命令——它早在 2024 年前就被彻底移除，当前（2026 年）所有主流 Homebrew 版本（如 v4.0.26）执行 brew switch 都会报错：Error: Unknown command: switch。这不是你配置的问题，而是官方主动弃用的结果。
你需要的是更可靠、更轻量的原生命令组合，而不是寻找已失效的功能。
安装多个版本的软件
Homebrew 支持「版本化 formula」，比如 php@8.2、node@18、go@1.18、openjdk@17，这些不是插件或第三方 tap，而是官方直接维护的独立包：
- 直接运行
brew install php@8.2或brew install node@18即可安装 - 每个版本安装路径完全隔离：
/opt/homebrew/opt/php@8.2/bin/php（Apple Silicon）或/usr/local/opt/node@18/bin/node（Intel） - 不会覆盖系统命令，也不会互相冲突，只是“待命状态”
注意：php@7.4 及更早、node@14 等老旧版本 Homebrew 已停止提供；若项目强依赖，建议迁移到 8.x 或改用容器、phpbrew、nvm 等专用方案。
用 unlink + link 切换全局默认版本
这是最通用、兼容性最强的方式，适用于 PHP、Node、Go、Java（JDK）、Python 等所有支持 versioned formula 的工具：
- 先断开当前链接：
brew unlink php - 再强制链接目标版本：
brew link --force php@8.2 - 验证是否生效：
which php应返回/opt/homebrew/bin/php，php -v显示对应版本
该操作会影响所有新打开的终端（因 shell 初始化时读取 PATH），但不会影响已运行的后台进程（如正在监听的 php -S 或 go run main.go）。
按项目隔离版本（无需全局切换）
全局切换适合日常开发，但团队协作或老项目常需「每个项目用不同版本」。这时推荐两种方式：
-
PATH 前置法（推荐）：在项目根目录下创建
.zshrc.local或.env，写入：export PATH="/opt/homebrew/opt/php@7.4/bin:/opt/homebrew/opt/php@7.4/sbin:$PATH"
然后在项目目录中执行
source .zshrc.local && php -v
Smart Model Switcher V5下载智能模型自动切换 V5.0.2 - 多模态感知，自动识别图片/视频/音频/代码/文本任务，切换最优模型。支持图片理解(qwen3-vl-plus)、视频音频(qwen3.5-plus)、代码(glm-5)、Office文档(MiniMax-M2.5)、推理等场景。零感知切换，无需手动操作。
-
封装 bin/php 脚本：新建
bin/php，内容为：#!/bin/bash /opt/homebrew/opt/php@7.4/bin/php "$@"
加上可执行权限：
chmod +x bin/php，后续用./bin/php -v即可精准调用
替代方案：按语言选更专业的工具
某些语言生态已有成熟、语义清晰的版本管理器，比手动 link 更适合长期使用：
Node.js：用
fnm（轻快）或nvm（功能全）brew install fnm && fnm install 18.19.0 && fnm use 18.19.0Java：用
jenv统一注册和切换brew install jenv && jenv add /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/HomePython：
pyenv是事实标准，Homebrew 安装后可管理任意 CPython 版本brew install pyenv && pyenv install 3.11.9 && pyenv local 3.11.9
这些工具不依赖 Homebrew 的 link 机制，支持 per-project、per-shell 级别切换，也更容易集成进 IDE 和 CI 流程。
不复杂但容易忽略。
