在 M1 Mac 上安装 Homebrew
问题描述
许多用户在新购买的 M1/M2 系列芯片的 MacBook 上安装 Homebrew 时遇到问题。安装过程看似成功，但终端无法识别 brew 命令，并提示路径配置错误。这是因为 Apple Silicon Mac 的架构（ARM64）与之前的 Intel 芯片（x86_64）不同，导致 Homebrew 的安装路径发生了变化。
解决方案
根据 Homebrew 官方推荐和社区验证，以下是针对 Apple Silicon Mac 的正确安装方法。
方法一：官方推荐安装（最新方法）
推荐使用
这是 Homebrew 官方当前推荐的安装方式，适用于 macOS Monterey 及更高版本。
打开终端（Terminal）
运行安装脚本：
bash/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"按照终端提示完成配置： 安装完成后，终端会显示类似下面的提示信息：
==> Next steps: - Run these two commands in your terminal to add Homebrew to your PATH: echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)" - Run brew help to get started执行路径配置命令： 复制并执行终端中显示的两个命令：
bashecho 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)"验证安装：
bashbrew help如果显示 Homebrew 的帮助信息，说明安装成功。
方法二：手动配置路径（传统方法）
如果上述方法不起作用，可以尝试手动配置路径：
创建或编辑
.zshrc文件：bashtouch ~/.zshrc添加路径配置： 使用文本编辑器打开
~/.zshrc文件，在文件末尾添加：bashexport PATH=/opt/homebrew/bin:$PATH使配置生效：
bashsource ~/.zshrc验证安装：
bashbrew help
常见问题与解决方案
1. 命令行工具（CLT）架构错误
如果遇到类似以下错误：
xcrun: error: unable to load libxcrun (dlopen(/Library/Developer/CommandLineTools/usr/lib/libxcrun.dylib, 0x0005): tried: '/Library/Developer/CommandLineTools/usr/lib/libxcrun.dylib' (mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64e'))解决方法：
bash
# 移除现有的命令行工具
sudo rm -rf /Library/Developer/CommandLineTools
# 重新安装命令行工具
xcode-select --install2. 找不到 .zprofile 或 .zshrc 文件
这些是隐藏文件，可以通过以下方式查看：
- 在 Finder 中：按下
Command + Shift + .显示隐藏文件 - 在终端中：使用
ls -a命令查看所有文件
3. 安装后命令仍不可用
如果按照上述步骤操作后 brew 命令仍然不可用，请尝试：
bash
# 重新加载 shell 配置
exec zsh
# 或者重启终端应用路径差异说明
| 芯片架构 | Homebrew 安装路径 | 配置文件 |
|---|---|---|
| Intel (x86_64) | /usr/local/bin | 无特殊要求 |
| Apple Silicon (ARM64) | /opt/homebrew/bin | 需要手动配置路径 |
总结
在 M1/M2 Mac 上安装 Homebrew 的关键点是确保正确配置路径。推荐使用官方提供的安装方法和路径配置命令，这样可以确保 Homebrew 在 Apple Silicon 架构下正常工作。
安装完成后，您可以使用 brew install 命令安装各种开发工具和软件包，享受 Homebrew 带来的便利。