macOS 使用 PKG 安装 Git 的完整方法|gwozai

macOS 使用 PKG 安装 Git 的完整方法

这个教程专注于通过 Git 官网的独立 .pkg 安装程序安装 Git（版本 2.33.0）。注意，此安装程序已过时（最后更新于 2021 年），可能不兼容较新的 macOS 版本（如 Sequoia）或 Apple Silicon 芯片（M1/M2/M3 等，需要 Rosetta 兼容模式）。推荐优先使用其他方法，如 Xcode Command Line Tools 或 Homebrew，以获取更新的 Git 版本（如 2.52+）。如果坚持使用 .pkg，以下是完整步骤，包括解决 macOS Gatekeeper “未知开发者”问题的命令行处理。

下载链接

官方下载：访问 https://git-scm.com/download/mac，点击 “Binary installer” 链接，转到 SourceForge 下载 git-2.33.0-intel-universal-mavericks.dmg（适用于 Intel Mac）。
替代下载分享链接：https://myfileforever.lanzouq.com/iWruJ3c6hxfc（密码: e8qf）。下载后，将 .dmg 文件移到桌面（~/Desktop）以匹配命令路径。

安装方法

整个过程在 Terminal（终端）中操作。打开 Terminal（通过 Spotlight 搜索 Command + Space，然后输入 “Terminal”）。

准备工作：
- 确保已安装 Xcode Command Line Tools（可选但推荐，提供必要工具）：运行命令 xcode-select --install，系统会弹出窗口，点击“安装”并等待完成。
- 下载 .dmg 文件到桌面。
处理 Gatekeeper 隔离问题并安装（推荐命令行组合）：
- 如果遇到“无法打开，因为它来自身份不明的开发者”错误，这是 macOS 安全机制。用以下单一命令链解决（复制粘贴到 Terminal，按 Enter，可能需要输入管理员密码）：
```
hdiutil detach "/Volumes/Git 2.33.0 Mavericks Intel Universal 1" || true && hdiutil attach ~/Desktop/git-2.33.0-intel-universal-mavericks.dmg && cp "/Volumes/Git 2.33.0 Mavericks Intel Universal 1/git-2.33.0-intel-universal-mavericks.pkg" ~/Desktop/ && xattr -rd com.apple.quarantine ~/Desktop/git-2.33.0-intel-universal-mavericks.pkg && sudo installer -pkg ~/Desktop/git-2.33.0-intel-universal-mavericks.pkg -target /
```
- 命令详细解释：
  - hdiutil detach ... || true：卸载可能已挂载的卷（忽略如果不存在的错误）。
  - hdiutil attach ...：挂载 .dmg 文件，创建卷（卷名为 “Git 2.33.0 Mavericks Intel Universal 1”，注意有空格和数字）。
  - cp ...：将 .pkg 文件复制到桌面，避免挂载卷的只读文件系统问题。
  - xattr -rd com.apple.quarantine ...：递归移除 .pkg 文件的隔离（quarantine）属性，解决“未知开发者”警告。
  - sudo installer -pkg ... -target /：使用 installer 命令安装 .pkg 到系统根目录（需要 sudo 权限）。
手动步骤（如果组合命令失败）：
- 移除 .dmg 隔离：xattr -d com.apple.quarantine ~/Desktop/git-2.33.0-intel-universal-mavericks.dmg。
- 挂载 .dmg：hdiutil attach ~/Desktop/git-2.33.0-intel-universal-mavericks.dmg 或在 Finder 双击。
- 复制 .pkg：cp "/Volumes/Git 2.33.0 Mavericks Intel Universal 1/git-2.33.0-intel-universal-mavericks.pkg" ~/Desktop/。
- 移除 .pkg 隔离：xattr -rd com.apple.quarantine ~/Desktop/git-2.33.0-intel-universal-mavericks.pkg。
- 安装：sudo installer -pkg ~/Desktop/git-2.33.0-intel-universal-mavericks.pkg -target /。
- 卸载卷（清理）：hdiutil detach "/Volumes/Git 2.33.0 Mavericks Intel Universal 1"。
验证安装：
- 运行 git --version，应显示类似 “git version 2.33.0”。
- 如果未找到 git，重启 Terminal 或检查路径（默认安装到 /usr/local/bin/git）。
配置 Git：
- 设置用户名：git config --global user.name "Your Name"。
- 设置邮箱：git config --global user.email "your@email.com"。
- 测试：创建一个测试仓库 mkdir test-repo && cd test-repo && git init，然后添加文件 echo "Hello" > file.txt && git add . && git commit -m "Initial commit"。

注意事项和故障排除

兼容性：适用于 macOS Ventura、Sonoma 或 Sequoia；对于 Apple Silicon Mac，如果安装失败，尝试在 Terminal 启用 Rosetta（arch -x86_64 /bin/zsh 然后重试）。
权限错误：命令中已包含 sudo；如果提示密码，输入你的 Mac 管理员密码（输入时不显示字符）。
文件名不匹配：用 ls ~/Desktop 检查确切文件名，并调整命令（例如，如果卷名为 “Git 2.33.0 Mavericks Intel Universal” 而非带 “1”，去掉 “1”）。
安装失败：检查下载文件完整性（重新下载）；或切换到推荐方法：
- Xcode：运行 git --version 自动安装。
- Homebrew：先安装 Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，然后 brew install git。
更新 Git：此 .pkg 方法无自动更新；安装后若需更新，卸载旧版并用 Homebrew 重新安装。
安全提示：仅从官方或信任链接下载；安装后可删除 .dmg 和 .pkg 文件。