☰
Mac开发者必备:Homebrew安装与使用全指南
2026/11/2 7:19:41 网站建设 项目流程

1. 为什么Mac开发者离不开Homebrew

作为一名在Mac平台开发超过8年的全栈工程师,我可以负责任地说:Homebrew是每个Mac用户的必备工具。它彻底改变了我们在macOS上管理软件包的方式,就像App Store对普通用户的意义一样重要。

记得2015年我第一次接触Homebrew时,还在用繁琐的源码编译方式安装MySQL,需要手动解决各种依赖冲突。而Homebrew的出现,让软件安装变得像brew install mysql这么简单。它不仅解决了"依赖地狱"问题,更重要的是建立了一套统一的软件管理规范。

对于不同芯片架构的Mac设备,Homebrew会自动适配:

  • Intel芯片:默认安装到/usr/local
  • Apple Silicon(M1/M2/M3):自动使用/opt/homebrew 这种智能处理让开发者无需关心底层差异,真正实现了"一次安装,到处运行"。

2. 手把手安装Homebrew(含国内镜像方案)

2.1 基础安装命令

官方推荐的一键安装命令是:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

但根据我的经验,国内用户直接运行这个命令90%会失败。主要问题有:

  1. GitHub raw域名被间歇性屏蔽
  2. 下载速度可能只有几KB/s
  3. 中途超时导致安装不完整

2.2 国内镜像加速方案

推荐使用清华大学开源镜像站的方案:

# 先设置环境变量 export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git" export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git" # 再执行安装脚本 /bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/Homebrew/install@HEAD/install.sh)"

注意:安装完成后需要将brew程序添加到PATH。对于M系列芯片Mac,需要在~/.zshrc中添加:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc source ~/.zshrc

2.3 验证安装成功

运行以下命令检查:

brew doctor

正常应该显示"Your system is ready to brew"。如果出现警告,通常是权限问题,可以用:

sudo chown -R $(whoami) $(brew --prefix)/*

3. Homebrew核心使用技巧

3.1 软件管理四件套

# 搜索软件(如搜索MySQL) brew search mysql # 查看软件信息 brew info mysql # 安装软件(以MySQL 8.0为例) brew install mysql@8.0 # 卸载软件 brew uninstall mysql@8.0

3.2 服务管理

对于有后台服务的软件(如Nginx/MySQL),Homebrew提供了便捷的服务控制:

# 启动服务 brew services start mysql # 查看运行状态 brew services list # 停止服务 brew services stop mysql

3.3 高级用法

  1. 安装特定版本软件:
# 先搜索可用版本 brew search mysql@ # 再安装指定版本 brew install mysql@5.7
  1. 清理旧版本:
brew cleanup
  1. 查看依赖树:
brew deps --tree mysql

4. 常见问题解决方案

4.1 安装卡死问题

如果安装过程中卡在Updating Homebrew,可以:

  1. 按Control+C中断
  2. 执行export HOMEBREW_NO_AUTO_UPDATE=1
  3. 重新运行安装命令

4.2 权限被拒绝错误

典型错误:Error: Permission denied @ dir_s_mkdir解决方案:

sudo chown -R $(whoami) /usr/local/*

4.3 M1芯片兼容性问题

如果遇到Rosetta相关错误,可以:

# 为终端启用Rosetta arch -x86_64 zsh # 然后重新安装 brew install

5. 我的Homebrew最佳实践

经过多年使用,总结出这些经验:

  1. 定期维护:
brew update && brew upgrade && brew cleanup
  1. 使用Bundler管理开发环境:
# 创建Brewfile brew bundle dump # 恢复环境 brew bundle install
  1. 重要配置备份:
# 备份已安装软件列表 brew leaves > brew_packages.txt # 备份tap列表 brew tap > brew_taps.txt
  1. 疑难排查三板斧:
brew doctor # 检查健康状况 brew config # 查看配置 brew gist-logs <formula> # 获取错误日志

对于国内用户,我强烈建议配置镜像源。在~/.zshrc中添加:

export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api" export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles" export HOMEBREW_PIP_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询