Homebrew是macOS管理开发环境最实用的方式,需先装Xcode命令行工具并确认shell为zsh;装Java需指定版本如openjdk@17并动态配置JAVA_HOME;Python单版本用brew install python,多版本用pyenv;日常用brew search/install/uninstall管理包。
homebrew 是 macos 上管理开发语言运行环境最实用的方式,装对了、配好了,一条命令就能装、换、删版本,还能自动处理依赖。关键不是“能不能装”,而是“装得稳不稳、管得住不管得住”。
先打好基础:Xcode 命令行工具 + 正确 shell
这两步跳过,后续大概率卡在编译失败或命令找不到。不是可选项,是硬前提:
- 运行 xcode-select --install,弹窗点安装;完成后执行 xcode-select -p,输出 /Library/Developer/CommandLineTools 才算成功
- macOS Catalina 及以后默认用 zsh,执行 echo $SHELL 确认是 /bin/zsh;如果是 bash,配置文件是 ~/.bash_profile,zsh 则是 ~/.zshrc 或 ~/.zprofile(具体看安装脚本提示)
装 Java:别只 brew install java
这条命令默认装的是 OpenJDK 21(当前最新 LTS),不是 JDK 8 或 17。项目要求 JDK 17?得明确指定:
- 运行 brew install openjdk@17
- 装完后必须手动设 JAVA_HOME:在 ~/.zshrc 末尾加一行 export JAVA_HOME=$(/usr/libexec/java_home -v17)
- 别写死路径,-v17 会动态匹配已安装的最新 17.x 子版本;改完立刻 source ~/.zshrc,别只开新终端
管 Python:单版本够用,多版本靠 pyenv
Homebrew 装的 python 默认指向最新稳定版(如 3.12),但很多项目仍需 3.9、3.11 等旧版。直接 brew 切换版本不可行,推荐组合方案:
- 基础安装:brew install python(得最新版,带 pip3)
- 多版本管理:brew install pyenv,再按提示把三行初始化代码追加到 ~/.zshrc,然后 source ~/.zshrc
- 之后用 pyenv install 3.9.18、pyenv install 3.11.9 安装所需版本,再用 pyenv global 3.9.18 或 pyenv local 3.11.9 控制作用域
日常维护:更新、查包、卸载就这三类操作
高频动作其实很集中,不用记太多命令:
- 查有没有:用 brew search xxx(比如 brew search node),结果里带 @ 符号的是版本化公式(如 node@18)
- 装或升级:命令行工具用 brew install xxx,图形应用用 brew install --cask xxx;保持全部更新只需两步:brew update && brew upgrade
- 卸载干净:用 brew uninstall xxx 或 brew uninstall --cask xxx;加 --force 可清残留,但慎用


















