mac 开发环境配置

兔子12135
6,142 阅读2分钟

在 macOS 上安装 Homebrew 的完整指南

Homebrew 是 macOS 上最受欢迎的包管理器，可以方便地安装各种开发工具和应用程序。以下是详细的安装步骤：

1. 安装前的准备

确保你的 macOS 满足以下要求：

  • macOS 10.14 (Mojave) 或更高版本

  • 已安装 Xcode 命令行工具（如果没有会自动安装）

  • 稳定的互联网连接

2. 安装 Homebrew

打开终端（Terminal.app），运行以下命令：

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

安装过程中：

  1. 系统可能会提示你安装 Xcode 命令行工具（如果尚未安装）

  2. 会要求你输入管理员密码

  3. 最后会显示安装成功的消息

3. 配置环境变量

安装完成后，Homebrew 会提示你将它的路径添加到你的 shell 配置文件中。对于 zsh（macOS Catalina 及更高版本的默认 shell），运行：

bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

4. 验证安装

运行以下命令检查 Homebrew 是否安装成功：

bash
brew --version

如果显示版本号（如 Homebrew 4.x.x），说明安装成功。

5. 基本使用命令

  • 搜索软件包：brew search 包名

  • 安装软件包：brew install 包名

  • 更新 Homebrew：brew update

  • 升级所有已安装的包：brew upgrade

  • 查看已安装的包：brew list

常见问题解决

1. 权限问题：如果遇到权限错误，可以尝试：

bash
sudo chown -R $(whoami) /opt/homebrew

2. 安装慢/卡住：可能是网络问题，可以尝试：

  • 使用国内镜像源

  • 检查网络连接

3. 命令未找到：如果 brew 命令仍然找不到，确保已正确执行第3步的环境变量配置。

安装完成后，你就可以使用 Homebrew 轻松安装各种开发工具和应用程序了！

这个错误信息 zsh: command not found: brew 表示你的系统无法找到 brew 命令，通常是因为 Homebrew 没有安装或者没有正确配置到你的 PATH 环境变量中。

解决方案：

1. 检查 Homebrew 是否已安装

运行以下命令检查 Homebrew 是否已安装：

bash
which brew

如果没有任何输出，说明 Homebrew 未安装。

2. 安装 Homebrew

如果未安装，可以通过以下命令安装 Homebrew（适用于 macOS 或 Linux）：

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

3. 配置 Homebrew 到 PATH

安装完成后，Homebrew 通常会提示你将它的路径添加到你的 shell 配置文件中（如 ~/.zshrc 或 ~/.bash_profile）。如果没有自动添加，可以手动添加以下内容到 ~/.zshrc 文件：

bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc

然后重新加载配置文件：

bash
source ~/.zshrc

4. 验证安装

运行以下命令验证 Homebrew 是否安装成功：

bash
brew --version

如果显示 Homebrew 的版本号，说明安装成功。

5. 其他可能的问题

  • 如果你使用的是 Linux，可能需要安装额外的依赖（如 build-essential 或 curl）。

  • 如果你使用的是 macOS，确保你的系统版本支持 Homebrew（通常 macOS 10.14 或更高版本）。

如果问题仍然存在，可以提供更多上下文信息（如操作系统、安装步骤等），以便进一步排查。

为 Homebrew 配置国内镜像源的完整指南

由于网络原因，直接从官方源安装可能较慢，以下是配置国内镜像源的方法：

1. 中科大镜像源配置（推荐）

替换 Homebrew 核心仓库

bash
# 替换 brew.git
git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git

# 替换 homebrew-core.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git

# 替换 homebrew-cask.git（用于GUI应用）
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git

替换 Homebrew Bottles（预编译二进制包）

对于 zsh 用户：

bash
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc
source ~/.zshrc

2. 清华镜像源配置（备选）

替换仓库源

bash
# 替换 brew.git
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git

# 替换 homebrew-core.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git

# 替换 homebrew-cask.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git

替换 Bottles 源

bash
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.zshrc
source ~/.zshrc

3. 验证配置

检查是否配置成功：

bash
brew config | grep 'HOMEBREW_BOTTLE_DOMAIN'

4. 重置为官方源（如需还原）

bash
# 重置 brew.git
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git

# 重置 homebrew-core.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git

# 重置 homebrew-cask.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask.git

# 删除环境变量
sed -i '' '/HOMEBREW_BOTTLE_DOMAIN/d' ~/.zshrc
source ~/.zshrc

注意事项

  1. 只需选择一种镜像源（中科大或清华），不要同时配置多个

  2. 配置完成后，建议运行 brew update 更新索引

  3. 如果遇到问题，可以先尝试 brew doctor 诊断

  4. 某些特别新的软件包可能在镜像源中尚未同步，此时可以临时取消镜像设置

使用国内镜像源可以显著提高 Homebrew 的下载速度，特别是在安装大型软件包时效果更为明显。

avatar
文章
阅读
粉丝