MacOS 系统下 Git 的详细安装步骤与基础设置指南

---

  

---

---

一、安装 Git

方法 1：通过 Homebrew 安装（保举）

• 安装 Homebrew（若未安装）：
  
  1. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  复制代码
  • 安装完成后，重启终端。
  
• 通过 Homebrew 安装 Git：
  
  1. brew install git

  复制代码
• 验证安装：
  
  1. git --version

  复制代码
  • 输出类似 git version 2.39.0 表示乐成。
  

---

方法 2：通过 Xcode Command Line Tools 安装

• 安装 Xcode Command Line Tools：
  
  1. xcode-select --install

  复制代码
  • 系统会弹出图形化安装界面，按提示完成安装。
  
• 验证 Git 是否自带安装：
  
  1. git --version

  复制代码
  • MacOS 默认会安装 Git，但版本可能较旧（如 2.37.0）。
  

---

方法 3：手动下载安装包

• 访问 Git 官网下载页面：
  https://git-scm.com/download/mac
  
• 下载 .dmg 文件（如 git-2.39.0-intel-universal-mavericks.dmg）。
  
• 挂载并安装：
  • 双击下载的 .dmg 文件，将 Git.app 拖入 Applications 文件夹。
  
• 配置环境变量：
  1. # 将 Git 添加到 PATH（若手动安装未自动配置）
  2. echo 'export PATH="/Applications/Git.app/Contents/Resources/bin:$PATH"' >> ~/.zshrc
  3. source ~/.zshrc

  复制代码

---

二、基础配置

1. 设置全局用户名和邮箱

1. git config --global user.name "Your Name"
2. git config --global user.email "your.email@example.com"

复制代码

• 验证配置：

1. git config --global --list

复制代码

---

2. 配置 SSH 密钥（用于 GitHub/GitLab 等）

• 生成 SSH 密钥：
  
  1. ssh-keygen -t ed25519 -C "your.email@example.com"

  复制代码
  • 按提示生存密钥到默认路径（~/.ssh/id_ed25519）。
  • 设置密钥暗码（可选）。
  
• 将公钥添加到 GitHub/GitLab：
  • 复制公钥内容：
  
  1. cat ~/.ssh/id_ed25519.pub

  复制代码
  • 登录 GitHub → Settings → SSH and GPG Keys → 添加新 SSH Key。
  
• 测试 SSH 连接：
  
  1. ssh -T git@github.com

  复制代码
  • 乐成提示：Hi username! You've successfully authenticated.
  

---

3. 配置 Git 别名（简化命令）

1. git config --global alias.co checkout
2. git config --global alias.br branch
3. git config --global alias.st status
4. git config --global alias.lg "log --oneline --graph --all"

复制代码

• 示例：git st 等同于 git status。

---

4. 启用 Git 自动换行符转换

1. git config --global core.autocrlf input  # MacOS/Linux
2. git config --global core.safecrlf warn    # 检测混合换行符

复制代码

---

三、高级设置

1. 配置差别工具（如 Beyond Compare）

• 安装 Beyond Compare（需购买或下载试用版）。
  
• 配置 Git 调用 Beyond Compare：
  1. git config --global merge.tool bc3
  2. git config --global mergetool.bc3.path "/Applications/Beyond Compare.app/Contents/MacOS/bcomp"

  复制代码

---

2. 配置 Git 署理（办理网络题目）

1. # HTTP/HTTPS 代理
2. git config --global http.proxy http://127.0.0.1:7890
3. git config --global https.proxy https://127.0.0.1:7890
5. # SOCKS5 代理（如 Clash）
6. git config --global http.proxy socks5://127.0.0.1:7890
7. git config --global https.proxy socks5://127.0.0.1:7890
9. # 取消代理
10. git config --global --unset http.proxy
11. git config --global --unset https.proxy

复制代码

---

四、常见题目与办理方法

1. 安装失败：Error: The following directories are not writable by your user

• 办理：利用 sudo 或修复目次权限：

1. sudo chown -R $(whoami) /usr/local/*

复制代码

---

2. 权限错误：Permission denied (publickey)

• 办理：

• 确认 SSH 密钥已添加到 ssh-agent：
  1. eval "$(ssh-agent -s)"
  2. ssh-add ~/.ssh/id_ed25519

  复制代码
• 检查公钥是否正确添加到 GitHub/GitLab。
  

---

3. Git 版本过旧

• 升级 Git：

1. brew update && brew upgrade git

复制代码

---

4. 终端提示 git: command not found

• 办理：
• 检查是否已安装 Git：which git。
• 若未安装，通过上述方法重新安装。
• 确保 Git 路径在环境变量中（echo $PATH）。

---

五、卸载 Git

1. # 通过 Homebrew 卸载
2. brew uninstall git
4. # 手动删除（若通过 dmg 安装）
5. sudo rm -rf /Applications/Git.app
6. sudo rm -rf /usr/local/git

复制代码

---

六、学习资源保举

• Pro Git 电子书（免费）：
  https://git-scm.com/book/zh/v2
  
• GitHub 官方教程：
  https://guides.github.com/
  
• Git 命令速查表：
  https://education.github.com/git-cheat-sheet-education.pdf
  

---

通过以上步骤，您可以在 MacOS 上快速安装并配置 Git，满足日常开发需求！

---

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。