1. 为什么Mac开发者离不开Homebrew如果你刚入手Mac电脑可能会被各种软件安装方式搞得头晕眼花。*.dmg拖拽安装、App Store下载、源码编译...每种方式都有其适用场景但最让开发者青睐的莫过于Homebrew这个包管理器。简单来说它就像Mac上的软件管家一条命令就能搞定安装、更新、卸载等操作。我最初接触Homebrew是因为需要安装Python3环境。当时系统自带的还是Python2.7手动编译安装不仅步骤繁琐后期维护也麻烦。直到同事告诉我可以用brew install python一键搞定连带依赖库都自动配置好这才体会到什么叫真香。Homebrew主要有三大优势依赖自动管理比如安装MySQL时会自动下载所需的openssl等库环境隔离所有软件都安装在独立目录不会污染系统路径统一管理用brew list就能查看所有通过Homebrew安装的软件2. 安装前的准备工作2.1 检查系统版本虽然Homebrew支持macOS 10.13及以上版本但我建议使用较新的系统。可以在终端输入以下命令查看系统信息sw_vers输出示例ProductName: macOS ProductVersion: 13.4 BuildVersion: 22F662.2 安装Xcode Command Line Tools这是Homebrew运行的基础依赖包含git、clang等必备工具。安装方法有两种自动安装推荐xcode-select --install手动安装如果自动安装失败rm -rf /Library/Developer/CommandLineTools xcode-select --install安装完成后验证xcode-select -p正常应该输出/Library/Developer/CommandLineTools3. 两种安装方式详解3.1 官方脚本安装适合网络环境好这是最直接的方式在终端执行/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)但实际安装时可能会遇到两个坑下载速度慢由于服务器在国外下载可能超时权限问题需要提前配置好sudo权限3.2 国内镜像加速安装推荐以清华源为例具体步骤先克隆安装脚本到本地git clone --depth1 https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git brew-install替换脚本中的仓库地址sed -i s/BREW_REPOhttps:\/\/github.com\/Homebrew\/brew/BREW_REPOhttps:\/\/mirrors.tuna.tsinghua.edu.cn\/git\/homebrew\/brew.git/g brew-install/install.sh执行安装/bin/bash brew-install/install.sh安装完成后别忘记配置环境变量。根据你的终端类型zsh/bash修改对应配置文件echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zshrc source ~/.zshrc4. 终端环境深度配置4.1 检查当前终端类型echo $SHELL常见输出/bin/zsh(macOS Catalina及以后默认)/bin/bash(较老系统默认)4.2 切换终端类型如果想从zsh切换到bashchsh -s /bin/bash切换后需要重新加载环境变量source ~/.bash_profile4.3 环境变量配置技巧建议将以下内容添加到终端配置文件.zshrc或.bash_profile# Homebrew export HOMEBREW_API_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git export HOMEBREW_NO_AUTO_UPDATE15. 日常使用指南5.1 基础命令速查命令作用示例brew install安装软件brew install wgetbrew uninstall卸载软件brew uninstall nodebrew list查看已安装brew list --versionsbrew update更新brewbrew update brew upgradebrew search搜索软件brew search mysql5.2 实用技巧安装特定版本软件brew install python3.9查看软件信息brew info nginx清理旧版本brew cleanup6. 常见问题排查6.1 安装报错Could not resolve host这通常是网络问题导致的可以尝试更换国内镜像源临时关闭VPN类软件检查DNS设置6.2 Permission denied错误需要给/usr/local目录赋权sudo chown -R $(whoami) /usr/local6.3 软件启动失败比如MySQL启动报错可以查看日志tail -n 100 /usr/local/var/mysql/*.err7. 进阶配置建议7.1 使用Homebrew Services管理服务安装服务管理插件brew tap homebrew/services常用命令brew services start mysql # 启动 brew services stop redis # 停止 brew services list # 查看所有服务7.2 安装图形界面应用Homebrew不仅可以装命令行工具还能安装GUI应用brew install --cask firefox7.3 创建自己的Formula如果需要安装特殊软件可以自定义Formulaclass Myapp Formula desc Description homepage https://example.com url https://example.com/myapp-1.0.tar.gz sha256 a1b2c3d4e5f6... def install system ./configure, --prefix#{prefix} system make, install end end保存为myapp.rb后即可用brew install ./myapp.rb安装
Mac上Homebrew的安装与配置全攻略
发布时间：2026/7/28 6:18:21
1. 为什么Mac开发者离不开Homebrew如果你刚入手Mac电脑可能会被各种软件安装方式搞得头晕眼花。*.dmg拖拽安装、App Store下载、源码编译...每种方式都有其适用场景但最让开发者青睐的莫过于Homebrew这个包管理器。简单来说它就像Mac上的软件管家一条命令就能搞定安装、更新、卸载等操作。我最初接触Homebrew是因为需要安装Python3环境。当时系统自带的还是Python2.7手动编译安装不仅步骤繁琐后期维护也麻烦。直到同事告诉我可以用brew install python一键搞定连带依赖库都自动配置好这才体会到什么叫真香。Homebrew主要有三大优势依赖自动管理比如安装MySQL时会自动下载所需的openssl等库环境隔离所有软件都安装在独立目录不会污染系统路径统一管理用brew list就能查看所有通过Homebrew安装的软件2. 安装前的准备工作2.1 检查系统版本虽然Homebrew支持macOS 10.13及以上版本但我建议使用较新的系统。可以在终端输入以下命令查看系统信息sw_vers输出示例ProductName: macOS ProductVersion: 13.4 BuildVersion: 22F662.2 安装Xcode Command Line Tools这是Homebrew运行的基础依赖包含git、clang等必备工具。安装方法有两种自动安装推荐xcode-select --install手动安装如果自动安装失败rm -rf /Library/Developer/CommandLineTools xcode-select --install安装完成后验证xcode-select -p正常应该输出/Library/Developer/CommandLineTools3. 两种安装方式详解3.1 官方脚本安装适合网络环境好这是最直接的方式在终端执行/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)但实际安装时可能会遇到两个坑下载速度慢由于服务器在国外下载可能超时权限问题需要提前配置好sudo权限3.2 国内镜像加速安装推荐以清华源为例具体步骤先克隆安装脚本到本地git clone --depth1 https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git brew-install替换脚本中的仓库地址sed -i s/BREW_REPOhttps:\/\/github.com\/Homebrew\/brew/BREW_REPOhttps:\/\/mirrors.tuna.tsinghua.edu.cn\/git\/homebrew\/brew.git/g brew-install/install.sh执行安装/bin/bash brew-install/install.sh安装完成后别忘记配置环境变量。根据你的终端类型zsh/bash修改对应配置文件echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zshrc source ~/.zshrc4. 终端环境深度配置4.1 检查当前终端类型echo $SHELL常见输出/bin/zsh(macOS Catalina及以后默认)/bin/bash(较老系统默认)4.2 切换终端类型如果想从zsh切换到bashchsh -s /bin/bash切换后需要重新加载环境变量source ~/.bash_profile4.3 环境变量配置技巧建议将以下内容添加到终端配置文件.zshrc或.bash_profile# Homebrew export HOMEBREW_API_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git export HOMEBREW_NO_AUTO_UPDATE15. 日常使用指南5.1 基础命令速查命令作用示例brew install安装软件brew install wgetbrew uninstall卸载软件brew uninstall nodebrew list查看已安装brew list --versionsbrew update更新brewbrew update brew upgradebrew search搜索软件brew search mysql5.2 实用技巧安装特定版本软件brew install python3.9查看软件信息brew info nginx清理旧版本brew cleanup6. 常见问题排查6.1 安装报错Could not resolve host这通常是网络问题导致的可以尝试更换国内镜像源临时关闭VPN类软件检查DNS设置6.2 Permission denied错误需要给/usr/local目录赋权sudo chown -R $(whoami) /usr/local6.3 软件启动失败比如MySQL启动报错可以查看日志tail -n 100 /usr/local/var/mysql/*.err7. 进阶配置建议7.1 使用Homebrew Services管理服务安装服务管理插件brew tap homebrew/services常用命令brew services start mysql # 启动 brew services stop redis # 停止 brew services list # 查看所有服务7.2 安装图形界面应用Homebrew不仅可以装命令行工具还能安装GUI应用brew install --cask firefox7.3 创建自己的Formula如果需要安装特殊软件可以自定义Formulaclass Myapp Formula desc Description homepage https://example.com url https://example.com/myapp-1.0.tar.gz sha256 a1b2c3d4e5f6... def install system ./configure, --prefix#{prefix} system make, install end end保存为myapp.rb后即可用brew install ./myapp.rb安装
