Homebrew 在 Mac 上的安装与使用指南

Homebrew 在 Mac 上的安装与使用指南

一、安装 Homebrew

推荐：国内镜像安装（速度最快）

方法 1：使用中科大镜像源

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

方法 2：使用清华镜像源

/bin/zsh -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/install/homebrew.sh)"

备选：官方安装（可能需要科学上网）

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

二、环境变量配置

安装后验证是否配置成功

# 查看 brew 命令是否可用（一般安装的时候会自动配置好环境变量）
brew -v
# 如果显示 "command not found"，需要手动配置环境变量

配置环境变量（选择一种方式）

方式 1：完整配置（推荐）

# 添加到 ~/.zshrc 或 ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

方式 2：简化配置

echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zshrc
source ~/.zshrc

方式 3：多配置文件都配置（确保兼容性）

# 同时配置多个文件
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshenv

国内镜像加速配置（可选但推荐）

# 将以下内容添加到 ~/.zprofile 或 ~/.zshell
export HOMEBREW_API_DOMAIN="https://mirrors.aliyun.com/homebrew/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.aliyun.com/homebrew/homebrew-bottles"
export HOMEBREW_PIP_INDEX_URL="http://mirrors.aliyun.com/pypi/simple"

三、基础使用命令

软件包管理

# 搜索软件
brew search [软件名]
# 例：brew search python

# 安装软件
brew install [软件名]
# 例：brew install wget

# 卸载软件
brew uninstall [软件名]
# 例：brew uninstall wget

# 列出已安装软件
brew list # 查看所有已安装

# 查看软件信息
brew info [软件名] # 显示详细信息

系统维护

# 更新 Homebrew 自身
brew update

# 升级所有已安装软件
brew upgrade

# 仅升级指定软件
brew upgrade [软件名]

# 清理旧版本
brew cleanup

# 查看可清理的内容
brew cleanup -n

# 诊断 Homebrew 问题
brew doctor

高级管理

# 查看过时的软件
brew outdated

# 锁定软件版本（防止升级）
brew pin [软件名]

# 解锁软件版本
brew unpin [软件名]

# 查看依赖关系
brew deps [软件名]

# 查看依赖
brew uses [软件名] # 查看被谁依赖

四、服务管理（如 MySQL、Nginx）

# 启动服务
brew services start [服务名]
# 例：brew services start mysql

# 停止服务
brew services stop [服务名]

# 重启服务
brew services restart [服务名]

# 查看所有服务状态
brew services list

# 设置开机自启
brew services start [服务名] --auto

五、常用软件包推荐

# 开发工具
brew install git # 版本控制
brew install node # Node.js
brew install [email protected] # Python
brew install openjdk # Java
brew install go # Go 语言

# 实用工具
brew install wget # 下载工具
brew install tree # 目录树显示
brew install htop # 进程监控
brew install neofetch # 系统信息
brew install fzf # 文件搜索

六、注意事项

1. Intel 与 Apple Silicon 区别
   • Intel Mac：Homebrew 默认安装在 /usr/local
   • Apple Silicon Mac：Homebrew 默认安装在 /opt/homebrew
2. 配置文件加载顺序
   • ~/.zshenv → ~/.zprofile → ~/.zshrc
   • 建议在 ~/.zprofile 中配置环境变量

七、卸载 Homebrew

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

八、定期维护

# 每月执行一次
brew update && brew upgrade && brew cleanup

提示：遇到问题可先执行 brew doctor 查看诊断信息。