Mac Homebrew 完整指南:从安装到维护
一、安装 Homebrew
1. 官方安装脚本
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 国内镜像安装
# 中国科大镜像
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
3. 手动安装
# 下载安装脚本
curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh > brew_install.sh
# 查看脚本内容
less brew_install.sh
# 执行安装
/bin/bash brew_install.sh
二、安装命令/包目录结构
1. 主要软链接位置
# Homebrew 软链接的主要位置
/usr/local/bin/ # Intel Mac
/opt/homebrew/bin/ # Apple Silicon Mac (M1/M2)
# 查看软链接命令
ls -la /usr/local/bin/ # Intel
ls -la /opt/homebrew/bin/ # Apple Silicon
2. Homebrew 目录结构
# 实际安装位置
/usr/local/Cellar/ # Intel Mac 包安装位置
/opt/homebrew/Cellar/ # Apple Silicon Mac 包安装位置
# 软链接层级
Cellar/[包名]/[版本]/bin/[可执行文件] # 实际文件位置
└── /usr/local/bin/ 或 /opt/homebrew/bin/ # 软链接位置
三、基本使用
1. 包管理命令
# 搜索软件
brew search [软件名]
# 安装软件
brew install [软件名]
# 卸载软件
brew uninstall [软件名]
# 更新 Homebrew
brew update
# 升级软件
brew upgrade [软件名]
2. 查询命令
# 查看已安装的软件
brew list
# 查看软件信息
brew info [软件名]
# 查看软件依赖
brew deps --installed --tree
四、软链接管理
1. 查看软链接
# 查看命令位置
which [命令名]
# 查看软链接详情
ls -l $(which [命令名])
# 查看包文件
brew list [包名]
2. 软链接操作
# 重建软链接
brew link [包名]
# 强制重建软链接
brew link --overwrite [包名]
# 创建自定义软链接
ln -s [源文件] [目标文件]
五、系统维护
1. 清理系统
# 清理旧版本
brew cleanup
# 清理缓存
brew cleanup --prune=all
# 删除无用依赖
brew autoremove
# 诊断系统
brew doctor
2. 定期维护流程
# 推荐的维护命令组合
brew update && \
brew upgrade && \
brew cleanup && \
brew doctor
六、环境配置
1. PATH 设置
# Intel Mac
export PATH="/usr/local/bin:$PATH"
# Apple Silicon Mac
export PATH="/opt/homebrew/bin:$PATH"
2. 权限修复
# 修复目录权限
sudo chown -R $(whoami) /usr/local/bin # Intel
sudo chown -R $(whoami) /opt/homebrew # Apple Silicon
3. linux系统查看所有的环境变量
# 打印所有的环境变量
printenv
# 过滤
printenv | grep GOPATH
七、故障排查
1. 常见问题
# 命令未找到
which brew
echo $PATH
# 软链接损坏
brew doctor
# 权限问题
sudo chown -R $(whoami):admin /usr/local/* # Intel
sudo chown -R $(whoami):admin /opt/homebrew/* # Apple Silicon
2. 诊断工具
# 系统诊断
brew doctor
# 依赖检查
brew missing
# 版本检查
brew list --versions
八、注意事项
- 清理前使用
-n
参数预览 - 重要软件操作前备份
- 区分 Intel 和 Apple Silicon 的路径差异
- 保持 PATH 环境变量正确配置
- 定期检查系统状态
参考:
文章:Mac安装brew的四种方法(指定能行)