Homebrew需先安装并配置国内镜像源才能正常使用:①执行官方脚本安装;②替换brew.git和bottle域为中科大源;③运行brew update验证;④再用brew install安装软件,遇连接失败可调DNS、关代理或重置SSL配置。

如果您希望在Mac终端中通过Homebrew安装软件,但尚未配置或无法正常使用Homebrew,则可能是由于Homebrew未安装、源不可达或环境变量未生效。以下是连接并使用Homebrew安装软件的具体步骤:
一、确认并安装Homebrew
Homebrew是macOS上主流的命令行包管理器,必须先完成安装才能执行后续软件安装操作。若终端输入brew --version报错“command not found”,说明尚未安装。
1、打开终端(可通过Spotlight搜索“Terminal”或在“应用程序→实用工具”中找到)。
2、执行官方安装命令:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
3、输入系统开机密码(输入时无回显,输完直接按回车)。
4、等待脚本自动下载、解压、初始化完成;Apple Silicon芯片(M1/M2/M3)会提示将路径写入~/.zprofile,Intel芯片则写入~/.zshrc或~/.bash_profile。
5、执行source ~/.zprofile(或对应配置文件)使路径立即生效。
6、运行brew --version,若显示版本号(如4.3.12),即表示Homebrew已成功安装并可连接。
二、切换为国内镜像源(解决连接缓慢或超时)
因GitHub原始源在国内访问不稳定,Homebrew默认连接可能失败或极慢,需手动替换为国内镜像源以保障连接可靠性与安装效率。
1、执行以下命令替换Brew核心仓库地址(中科大源):git -C $(brew --repo) remote set-url origin https://mirrors.ustc.edu.cn/brew.git。
2、执行以下命令替换Bottles二进制包源(中科大源):echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc && source ~/.zshrc。
3、验证是否生效:运行brew update,若不再卡在“Fetching latest commit…”且能快速列出更新项,即表明连接源已成功切换并稳定可用。
三、使用Homebrew安装任意软件
Homebrew安装软件依赖于其索引数据库,需确保已执行过brew update以同步最新包列表;所有安装命令均通过brew install触发,支持命令行工具与GUI应用两类。
1、安装命令行工具(例如Git):brew install git。
2、安装图形界面应用(需启用cask扩展):brew tap homebrew/cask,再执行brew install --cask visual-studio-code。
3、安装指定版本(如Python 3.11):brew install python@3.11。
4、安装后验证:运行brew list | grep git(或对应软件名),若返回结果,即表明软件已成功安装并可调用。
四、排查常见连接异常
当执行brew install失败并提示“Could not resolve host”、“Failed to connect”或“SSL certificate problem”时,通常由网络策略、DNS污染或证书失效导致,需针对性修复连接链路。
1、检查DNS解析:运行nslookup github.com,若无响应,尝试更换DNS为8.8.8.8或114.114.114.114。
2、临时关闭代理:若使用Clash、Surge等代理工具,终端中执行unset http_proxy https_proxy后再试。
3、重置Git HTTPS配置(适用于fatal: unable to access 'https://github.com/Homebrew/brew/':):git -C $(brew --repo) config --unset-all http.sslVerify,随后运行brew update。
4、若仍失败,可强制使用国内镜像安装脚本替代原始流程:/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)",该脚本内置多源选择及自动配置,可绕过GitHub直连依赖。










