commit all

10-WebClipper/Mac安装Homebrew教程：解决brew安装失败（国内镜像安装方法）国内Mac安装Homebrew的记录及常见问题解 - 掘金.md

@@ -0,0 +1,267 @@
+Homebrew 是 macOS 上最常用的包管理工具，可以帮助开发者快速安装各种软件，例如：
+
+*   Git
+*   Node.js
+*   Python
+*   Rust
+*   Docker
+
+通过 Homebrew，你只需要一条命令就可以安装软件，非常方便。
+
+不过在国内网络环境下，安装 Homebrew 时经常会出现连接 GitHub 失败的问题：
+
+```vbnet
+curl: (7) Failed to connect to raw.githubusercontent.com port 443
+
+```
+
+本文将介绍 **Mac安装Homebrew的完整教程**，并提供 **国内镜像安装方法** 来解决安装失败的问题。
+
+* * *
+
+一、官方安装 Homebrew（推荐）
+-------------------
+
+Homebrew 官方提供了安装脚本，可以通过以下命令安装：
+
+```bash
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+
+```
+
+执行后系统会自动下载 Homebrew 并完成安装。
+
+如果你的网络环境可以正常访问 GitHub，那么这种方式是最简单的。
+
+* * *
+
+二、国内镜像安装 Homebrew
+-----------------
+
+如果安装过程中出现 GitHub 连接失败，可以使用国内镜像安装。
+
+运行以下命令：
+
+```bash
+/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
+
+```
+
+该脚本会自动：
+
+*   下载 Homebrew
+*   配置国内镜像
+*   设置环境变量
+
+适合国内网络环境使用。
+
+* * *
+
+三、验证 Homebrew 是否安装成功
+--------------------
+
+安装完成后，在终端执行：
+
+```null
+brew -v
+
+```
+
+如果显示类似：
+
+```null
+Homebrew 4.x.x
+
+```
+
+说明 Homebrew 已经安装成功。
+
+* * *
+
+四、brew命令无法使用的解决方法
+-----------------
+
+如果执行 brew -v 出现：
+
+```bash
+command not found: brew
+
+```
+
+通常是因为环境变量没有配置成功。
+
+可以手动添加环境变量。
+
+编辑配置文件：
+
+```bash
+vim ~/.zprofile
+
+```
+
+添加以下内容：
+
+```bash
+export PATH="/opt/homebrew/bin:$PATH"
+
+```
+
+保存后执行：
+
+```bash
+source ~/.zprofile
+
+```
+
+重新打开终端即可。
+
+* * *
+
+五、Homebrew常用命令
+--------------
+
+安装软件：
+
+```null
+brew install git
+
+```
+
+更新软件源：
+
+```sql
+brew update
+
+```
+
+升级软件：
+
+```null
+brew upgrade
+
+```
+
+卸载软件：
+
+```null
+brew uninstall 软件名
+
+```
+
+* * *
+
+六、总结
+----
+
+在 Mac 上安装 Homebrew 时，常见问题主要是 **网络访问 GitHub 失败**。
+
+解决方法：
+
+1.  优先使用官方安装脚本
+2.  如果无法访问 GitHub，可以使用国内镜像安装
+3.  安装完成后检查环境变量
+
+配置完成后，就可以使用 Homebrew 安装各种开发工具。
+
+* * *
+
+常见问题 FAQ
+--------
+
+### 1、Mac安装Homebrew失败怎么办？
+
+如果安装 Homebrew 时出现 GitHub 连接失败，通常是网络问题导致的。
+
+可以尝试：
+
+*   使用国内镜像安装
+*   更换网络环境后重新安装
+*   稍后再次尝试
+
+一般情况下使用国内镜像即可解决问题。
+
+* * *
+
+### 2、brew安装完成后提示命令不存在怎么办？
+
+如果执行：
+
+```null
+brew -v
+
+```
+
+提示：
+
+```bash
+command not found: brew
+
+```
+
+说明环境变量没有配置成功。
+
+执行：
+
+```bash
+export PATH="/opt/homebrew/bin:$PATH"
+
+```
+
+或者添加到：
+
+```bash
+~/.zprofile
+
+```
+
+然后执行：
+
+```bash
+source ~/.zprofile
+
+```
+
+* * *
+
+### 3、Homebrew安装软件很慢怎么办？
+
+如果使用 Homebrew 安装软件速度很慢，可以考虑使用国内镜像源，例如：
+
+*   清华大学镜像
+*   中科大镜像
+
+更换镜像后下载速度会明显提升。
+
+* * *
+
+### 4、Homebrew 是做什么用的？
+
+Homebrew 是 macOS 上最流行的包管理工具，可以用来安装各种开发软件，例如：
+
+*   Git
+*   Node.js
+*   Python
+*   Rust
+*   Docker
+
+通过 Homebrew，可以用一条命令快速安装软件。
+
+* * *
+
+### 5、Homebrew 是否支持 Apple Silicon（M芯片）？
+
+支持，但是macOS26版本可能出现官方无法正确识别问题。
+
+在 Apple Silicon Mac 上，Homebrew 默认安装路径为：
+
+```bash
+/opt/homebrew
+
+```
+
+而 Intel Mac 默认路径为：
+
+```bash
+/usr/local
+
+```