一、安装 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 或 ~/.zshrc
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 python@3.9          # Python
brew install openjdk             # Java
brew install go                  # Go语言

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

六、注意事项

Intel 与 Apple Silicon 区别

• Intel Mac：Homebrew 默认安装在 /usr/local

• Apple Silicon Mac：Homebrew 默认安装在 /opt/homebrew

配置文件加载顺序

• ~/.zshenv → ~/.zprofile → ~/.zshrc

• 建议在 ~/.zprofile 中配置环境变量

定期维护

# 每月执行一次

brew update && brew upgrade && brew cleanup

卸载 Homebrew

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