Mac新手必看：保姆级Git+SourceTree配置指南，从SSH密钥到拉取代码一气呵成

Mac开发者入门：Git与SourceTree全流程配置实战手册

刚接触开发的Mac用户往往会在配置开发环境时遇到各种"小坑"。记得我第一次在Mac上配置Git和SourceTree时，花了整整一个下午才搞明白为什么SSH连接总是失败。本文将带你避开这些陷阱，从零开始完成Git环境搭建、SSH密钥配置到SourceTree仓库管理的完整流程。

1. 环境准备与Git基础配置

在开始之前，我们需要确保Mac系统已经安装了必要的工具链。打开终端（Terminal），输入以下命令检查Git是否已安装：

git --version

如果系统返回类似git version 2.32.0的版本信息，说明Git已经安装。否则，我们需要先安装Git。推荐通过Homebrew安装最新版本：

brew install git

安装完成后，我们需要进行基本的Git全局配置。这些信息将用于你未来的每一次代码提交：

git config --global user.name "你的姓名" git config --global user.email "你的邮箱" git config --global core.editor "code --wait" # 使用VS Code作为默认编辑器

提示：邮箱地址应该与你使用的代码托管平台（如GitHub、Gitee）注册邮箱一致，否则贡献统计可能无法正确关联。

为了验证配置是否生效，可以运行：

git config --global --list

2. SSH密钥生成与托管平台配置

SSH密钥是安全连接代码托管平台的核心。我们将生成一对密钥（公钥和私钥），并将公钥添加到托管平台账户中。

在终端执行以下命令生成SSH密钥对：

ssh-keygen -t ed25519 -C "你的邮箱"

系统会提示你选择密钥保存位置（默认~/.ssh/id_ed25519）和设置密码。建议：

• 保持默认位置
• 设置一个强密码（可选但推荐）
• 将密码保存在Mac钥匙串中方便后续使用

生成完成后，查看并复制公钥内容：

cat ~/.ssh/id_ed25519.pub | pbcopy

现在将公钥添加到你的代码托管平台：

• GitHub：Settings → SSH and GPG keys → New SSH key
• Gitee：设置 → SSH公钥 → 添加公钥

添加完成后，测试连接是否成功：

ssh -T git@github.com # 测试GitHub ssh -T git@gitee.com # 测试Gitee

第一次连接时会提示验证主机密钥，输入yes继续。成功后会显示欢迎信息。

3. SSH配置优化与问题排查

为了让SSH体验更顺畅，我们需要进行一些优化配置。创建或编辑~/.ssh/config文件：

nano ~/.ssh/config

添加以下内容：

Host * AddKeysToAgent yes UseKeychain yes IdentityFile ~/.ssh/id_ed25519

常见问题及解决方案：

1. 权限问题：

   chmod 600 ~/.ssh/config chmod 600 ~/.ssh/id_ed25519

2. Host key验证失败：

   ssh-keygen -R github.com # 清除旧密钥

3. 代理问题：

   eval "$(ssh-agent -s)" ssh-add --apple-use-keychain ~/.ssh/id_ed25519

4. SourceTree安装与基础配置

SourceTree是Mac上优秀的Git图形化客户端。从官网下载后，首次运行需要登录Atlassian账户（可免费注册）。

安装完成后，进行初始设置：

1. 在Preferences → Git中确认Git路径
2. 在Preferences → Diff中选择对比工具
3. 在Preferences → General中设置默认存储位置

注意：SourceTree可能会请求访问钥匙串中的SSH密钥，选择"始终允许"以避免重复输入密码。

5. 使用SourceTree管理Git仓库

让我们通过一个完整的工作流来熟悉SourceTree的基本操作。

克隆现有仓库

1. 点击"Clone"按钮
2. 输入仓库URL（如git@github.com:user/repo.git）
3. 选择本地存储路径
4. 点击"Clone"完成

创建新仓库

1. 点击"Create"按钮
2. 选择本地文件夹
3. 勾选"Create a repository"选项
4. 点击"Create"完成初始化

基础工作流

SourceTree界面主要分为以下几个区域：

• 左侧面板：仓库列表、分支列表等
• 中间面板：文件状态、提交历史等
• 右侧面板：差异对比、提交信息等

典型工作流程：

1. 修改文件后，文件会出现在"未暂存文件"区域
2. 勾选要提交的文件，填写提交信息
3. 点击"提交"按钮完成本地提交
4. 点击"推送"按钮将更改同步到远程仓库

6. 高级配置与实用技巧

多账户管理

如果你需要同时使用多个Git账户（如公司和个人账户），可以通过SSH配置实现：

# ~/.ssh/config Host github.com-personal HostName github.com User git IdentityFile ~/.ssh/id_ed25519_personal Host github.com-work HostName github.com User git IdentityFile ~/.ssh/id_ed25519_work

克隆仓库时使用对应的主机别名：

git clone git@github.com-personal:user/repo.git

Git钩子自动化

在仓库的.git/hooks目录中添加脚本可以实现自动化操作。例如，添加pre-commit钩子可以在提交前运行测试：

#!/bin/sh npm test

SourceTree自定义操作

在Preferences → Custom Actions中添加常用命令，如：

• 名称：Run Tests
• 脚本：npm test
• 参数：$REPO
• 工作目录：$REPO

7. 常见问题深度解决方案

SSH连接超时

如果遇到SSH连接超时问题，可能是网络限制导致。尝试以下方法：

1. 测试SSH连接详细日志：

   ssh -vT git@github.com

2. 修改SSH配置使用443端口：

   Host github.com Hostname ssh.github.com Port 443

SourceTree卡顿问题

大型仓库可能导致SourceTree性能下降，可以：

1. 在Preferences → Git中启用"Git GC"
2. 定期执行仓库维护：

   git gc --aggressive

3. 限制历史记录加载数量

文件权限问题

Mac和Linux系统对文件权限敏感，可能导致脚本无法执行。修复方法：

git config core.fileMode false # 忽略文件权限变化

或者在SourceTree中：

1. Preferences → Git → 取消勾选"Track file mode changes"

经过这些配置后，你的Mac开发环境应该已经准备就绪。在实际使用中，建议定期备份~/.ssh目录和重要的Git配置。遇到问题时，记住Git的--help参数和SourceTree的日志功能都是很好的排错工具。