Mac新手必看：用SourceTree和Git搞定Gitee/GitHub仓库（含SSH密钥配置避坑指南）
Mac新手极简指南：SourceTree+Git全流程图形化操作（附SSH密钥避坑手册）
刚接触Git的Mac用户往往面临一个矛盾：既想享受版本控制的强大功能，又对命令行操作心生畏惧。SourceTree作为一款免费的Git图形化工具，恰好能弥合这一鸿沟。本文将带你用最直观的方式完成从环境配置到首次提交的全流程，特别针对Mac特有的钥匙串权限、known_hosts验证等痛点提供解决方案。
1. 环境准备：Git与SourceTree的黄金组合
在Mac上使用Git通常有两种方式：纯命令行或图形化工具。对于新手而言，SourceTree提供了更友好的可视化操作界面，同时保留了Git的全部功能。以下是必备软件的获取方式：
- Git安装：打开终端输入
git --version，若未安装会提示安装命令行开发者工具。或通过Git官网下载最新版。 - SourceTree获取：从Atlassian官网下载时可能遇到注册要求，其实只需关闭注册窗口即可跳过。
注意：SourceTree 4.0+版本已原生支持Apple Silicon芯片，M1/M2用户无需担心兼容性问题。
安装完成后，建议先进行基础配置：
git config --global user.name "YourName" git config --global user.email "your_email@example.com"2. SSH密钥配置：Mac特有的三大坑点
图形化操作的前提是建立本地与代码托管平台的安全连接。以下是Gitee/GitHub通用的SSH密钥配置流程及避坑要点：
2.1 密钥生成与托管平台绑定
打开终端执行密钥生成命令：
ssh-keygen -t ed25519 -C "your_email@example.com"为什么用ed25519？比传统RSA算法更安全且密钥更短，但部分旧系统可能不兼容。
查看公钥内容并复制：
pbcopy < ~/.ssh/id_ed25519.pub登录Gitee/GitHub，在「设置」-「SSH公钥」中粘贴。Gitee建议同时添加
gitee.com和git@gitee.com两种格式的Host。
2.2 Mac钥匙串集成（关键步骤）
SourceTree常见报错「Permission denied」的根源在于私钥未正确加载。解决方法：
# 将私钥添加到ssh-agent并存入钥匙串 ssh-add --apple-use-keychain ~/.ssh/id_ed25519创建或修改~/.ssh/config文件：
Host * AddKeysToAgent yes UseKeychain yes IdentityFile ~/.ssh/id_ed255192.3 known_hosts验证跳过
首次连接常见警告「The authenticity of host can't be established」。提前将平台指纹加入信任列表：
# Gitee ssh-keyscan -t ecdsa gitee.com >> ~/.ssh/known_hosts # GitHub ssh-keyscan -t ecdsa github.com >> ~/.ssh/known_hosts测试连接：
ssh -T git@gitee.com # 成功会显示欢迎信息3. SourceTree图形化操作全流程
3.1 仓库克隆实战
- 启动SourceTree选择「克隆仓库」
- 输入SSH格式的仓库地址（如
git@gitee.com:username/repo.git） - 指定本地保存路径，注意：
- 路径不要包含中文或空格
- 建议新建专用目录（如
~/Code）
常见错误：若提示「这不是有效的源路径」，检查是否误用了HTTPS地址而非SSH。
3.2 提交与推送可视化
- 提交更改：勾选需要提交的文件，填写提交信息，建议遵循约定式提交规范
- 分支管理：右键即可创建/切换/合并分支，拖拽即可完成rebase
- 冲突解决：内置的合并工具比命令行更直观显示差异
3.3 高级功能速览
| 功能 | 入口位置 | 使用场景 |
|---|---|---|
| 贮藏更改 | 工具栏按钮 | 临时切换分支时保存工作进度 |
| 交互式变基 | 右键提交记录 | 修改历史提交信息 |
| LFS支持 | 偏好设置 | 管理大文件版本 |
4. 效率提升技巧与故障排查
4.1 加速操作的三个技巧
- 自定义操作：为常用命令创建快捷键（如「拉取」+「变基」组合）
- 忽略文件模板：全局配置
.gitignore避免重复设置git config --global core.excludesfile ~/.gitignore_global - SSH多账号管理：通过config文件区分不同平台的密钥
Host gitee.com HostName gitee.com User git IdentityFile ~/.ssh/id_ed25519_gitee
4.2 常见问题解决方案
问题：SourceTree提示「找不到git」
解决：在「偏好设置」-「Git」中手动指定路径（通常为/usr/local/bin/git）问题：提交后头像不显示
解决：检查邮箱是否与代码托管平台注册邮箱一致问题：推送被拒绝
解决：先用「拉取」解决远程变更，或强制推送（谨慎使用）
实际项目中，我习惯在SourceTree中为不同仓库设置自定义操作。比如为技术文档仓库添加「一键部署」脚本，只需右键即可完成构建和发布。这种深度集成让版本控制从负担变成了真正的生产力工具。