Homebrew 使用教程和常用命令总结,适用于 macOS 和 Linux 系统(通过 Linuxbrew)。
1. 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后,按提示将 Homebrew 添加到 PATH(通常需要修改 ~/.zshrc
或 ~/.bash_profile
)。
2. 基础命令
更新与维护
命令 | 说明 |
---|---|
brew update | 更新 Homebrew 自身和公式列表 |
brew upgrade | 升级所有已安装的包 |
brew upgrade <formula> | 升级指定包 |
brew outdated | 查看可升级的包 |
brew cleanup | 清理旧版本和缓存 |
安装与卸载
命令 | 说明 |
---|---|
brew install <formula> | 安装软件包(如 brew install node ) |
brew uninstall <formula> | 卸载软件包 |
brew list | 查看已安装的包 |
brew search <keyword> | 搜索软件包(支持正则表达式) |
信息查询
命令 | 说明 |
---|---|
brew info <formula> | 查看包详细信息(版本、依赖等) |
brew deps <formula> | 查看包的依赖 |
brew uses <formula> | 查看哪些包依赖该软件 |
3. 高级操作
管理服务(如 MySQL/Nginx)
命令 | 说明 |
---|---|
brew services start <formula> | 启动服务(如 brew services start mysql ) |
brew services stop <formula> | 停止服务 |
brew services restart <formula> | 重启服务 |
brew services list | 查看运行中的服务 |
诊断问题
命令 | 说明 |
---|---|
brew doctor | 检查系统是否存在潜在问题 |
brew config | 查看 Homebrew 配置和环境信息 |
brew --env | 显示环境变量 |
安装非标准包
命令 | 说明 |
---|---|
brew install --cask <app> | 安装 GUI 应用(如 brew install --cask google-chrome ) |
brew tap <user/repo> | 添加第三方仓库(如 brew tap homebrew/cask-fonts ) |
4. 常见问题
-
安装慢/下载失败
- 替换镜像源(国内用户推荐使用中科大或清华源):
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git" export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
- 或直接运行
brew install --force-bottle <formula>
使用预编译包。
- 替换镜像源(国内用户推荐使用中科大或清华源):
-
权限问题
- 如果提示
Permission denied
,尝试修复权限:sudo chown -R $(whoami) $(brew --prefix)/*
- 如果提示
-
卸载 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
5. 实用技巧
- 安装特定版本:
brew tap homebrew/cask-versions # 先添加版本库 brew install <formula>@<version> # 如 `node@14`
- 查看安装选项:
brew options <formula> # 显示可选的安装参数
- 清理缓存:
brew cleanup -s # 清理所有缓存和旧版本
通过以上命令,你可以高效管理 macOS/Linux 上的软件包。更多细节可通过 brew help
或官方文档 brew.sh 查看。