homebrew是macos下可一键安装、升级、卸载git/python/node.js等开发工具的包管理器；需先装xcode命令行工具，再通过国内镜像或官方脚本安装，并执行shellenv配置path，最后用brew --version、brew doctor和brew search验证环境。
如果你在 macOS 系统中需要快速安装 Git、Python、Node.js 等开发工具，却还在手动去官网下载 DMG、拖进 Applications、反复配 PATH，说明你还没装 Homebrew——这个能让终端一键搞定所有软件安装、升级、卸载的包管理器，现在就该装上。
先装好 Xcode 命令行工具
Homebrew 依赖编译器和系统头文件，没它，后续所有安装都会失败，报错“No developer tools were found”或“git not found”。这步不能跳过，也不能靠 brew 自动补全。
打开终端（Command + 空格 → 输入「终端」→ 回车），粘贴执行：xcode-select --install
弹窗点「安装」，等进度条走完；别关窗口，它不会自动退出，要等提示“The software was installed”才算结束。
验证是否真装上了：xcode-select -p
输出必须是 【/Library/Developer/CommandLineTools】，其他路径（比如空输出、/Applications/Xcode.app/…）都代表没装对，得立刻补一句 sudo xcode-select --reset 再试一次。
选一种方式装 Homebrew
官方脚本在国内常卡在 99%，镜像源才是日常首选。三种方法按成功率排序，推荐直接用方法二。
方法一：国内镜像一键安装（新手闭眼选）
终端里粘贴执行：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
出现菜单后输入 【2】（清华源，响应快、稳定性高），回车；接着输入开机密码（输的时候不显示字符，属正常，输完直接回车）；最后看到“==> 成功!”提示时，复制它给你的那行 eval "$(/opt/homebrew/bin/brew shellenv)" 并立即执行——这步漏掉，终端就认不出 brew 命令。
方法二：官方脚本直装（仅限网络极稳时）
终端执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按回车确认安装路径（默认 /opt/homebrew），输管理员密码；安装成功后终端会提示类似 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc 的命令，必须复制执行，再运行 source ~/.zshrc 才能让新配置生效。
方法三：pkg 图形化安装（完全不碰命令行）
访问 Homebrew 官方 Releases 页面，下载 homebrew.pkg 文件（注意看发布时间是否为 2026 年内）；双击打开，全程点「继续」「同意」「安装」，系统会自动完成部署，无需额外配置。
装完立刻验证是否真能用
第一步：检查 brew 命令是否识别brew --version
看到类似 【4.3.5】 这样的数字，说明命令已就位。
第二步：检查环境是否干净brew doctor
输出 【Your system is ready to brew.】 才算真正通过——如果提示 “Warning: Your Xcode is outdated” 或 “Warning: You have uncommitted modifications”，先别急着装软件，按提示逐条修复。
第三步：搜一个常用工具试试水brew search wget
能列出结果，且没有报错，说明整个链路已通。
