写代码这些年Git 几乎是绕不开的日常工具但命令行那一堆指令对不熟悉终端的人来说确实不友好。我见过太多同事在git push时被权限问题卡住或者在合并分支时对着终端一脸茫然。后来我慢慢转向 Sourcetree Gitee 这套组合发现它既能满足图形化操作的需求又能很好地融入国内的代码托管生态从身份验证到推送成功整个流程捋顺之后效率提升非常明显。这篇东西不是官方文档的翻译而是把我自己从安装、踩坑到最终顺畅推送的完整过程记录下来。无论你是刚接触 Git 的新手还是习惯命令行但想找个 GUI 工具辅助的老手这篇文章应该都能帮你省下不少时间。我会把身份验证、仓库关联、推送流程这些容易出问题的环节掰开揉碎地讲清楚尽量让你照着做就能跑通。1. 为什么选 Sourcetree 搭配 Gitee这套组合好在哪1.1 Sourcetree 能解决什么问题Sourcetree 是 Atlassian 推出的免费 Git 图形化客户端它解决的问题非常直接把 Git 的复杂操作变成可视化点击。你要知道Git 的命令行工具虽然强大但对人类记忆的负担实在太大——git rebase、git cherry-pick、git reset --hard这些指令光靠记忆很容易出错尤其在分支多、提交频繁的项目里。Sourcetree 的最大优势是“所见即所得”。提交历史以图形化界面展示分支的走向一目了然点击按钮就能完成暂存、提交、推送、拉取、合并等操作。我刚开始用它的时候最大的感受就是心里有底了。你知道自己当前在哪个分支知道本地和远程的差距是多少个提交不会因为敲错命令导致不可挽回的后果。另外Sourcetree 内置了 Diff 对比工具你可以直观地看到每一行代码的改动这比在终端里看密密麻麻的文本输出舒服太多。对于代码审查或者自己检查改动这个功能非常实用。1.2 为什么选择 Gitee 而不是其他平台Gitee码云是国内发展的代码托管平台对国内开发者来说有几个非常现实的优势。首先是速度快服务器在国内无论克隆还是推送都比访问境外平台稳定得多尤其是在网络环境波动的时候这个体验差异是巨大的。其次是 Gitee 的私有仓库免费。对于个人项目和中小企业来说这省下了一笔不小的费用。它的团队协作功能也够用比如 Pull Request、Issue 管理、Wiki 文档等基本满足日常研发流程的需要。Gitee 还支持一键导入 GitHub 仓库如果你之前在 GitHub 上有开源项目可以方便地迁移过来。还有一个很重要的点是Gitee 的文档和界面都是中文的对于英语不太熟练的开发者非常友好。它甚至有 Gitee 的桌面端和小程序方便你随时随地查看动态、处理 Issue。1.3 为什么推荐“SSH 密钥 Sourcetree”的组合我用过 HTTPS 方式配合 Sourcetree 连接 Gitee也用过 SSH 方式最终稳定下来的方案是“SSH 密钥认证 Sourcetree 操作”。核心原因是SSH 密钥不需要每次推送都输入密码而且更安全。使用 HTTPS 协议时如果你开启了两步验证或者频繁切换账号每次推送都可能被要求输入用户名和密码甚至需要使用私有令牌替代密码这在日常操作中相当打断节奏。SSH 方式通过公钥加密认证一旦配置好Sourcetree 就能自动识别密钥免密推送体验顺畅很多。当然SSH 也有一个初期门槛你得会生成密钥、配置公钥到 Gitee、让 Sourcetree 找到私钥。这个过程第一次做会觉得麻烦但配好之后一劳永逸。我会在后面的章节详细演示这一步。2. 环境准备安装 Sourcetree、Git 与 Gitee 账号2.1 安装前的必要准备在安装 Sourcetree 之前你至少需要准备以下内容一个 Gitee 账号。访问 Gitee 官网 注册即可手机号或者邮箱都能注册建议绑定手机号方便找回密码。Windows 或 macOS 系统。Sourcetree 对这两个系统都有对应的版本。确保本机网络可以正常访问 Gitee如果处于公司内网环境要注意网络策略是否限制 SSH 端口默认是 22。如果你已经装了 Git 命令行工具可以留着如果没装Sourcetree 安装时通常会自动配置内部的 Git不需要额外操心。这里有个容易忽略的点Sourcetree 依赖 Git 核心。如果你本机没有任何 Git 环境首次启动 Sourcetree 时它会提示安装内置的 Git 版本。我建议你允许它这样做因为 Sourcetree 内置的 Git 已经过测试兼容性最有保障。2.2 从下载到安装的完整步骤Sourcetree 的下载地址是 Atlassian 官网根据你的操作系统选择对应安装包。下载完成后双击安装文件基本一路 Next 就能完成安装。但有几个细节需要注意如果你已经装了 Git安装时可能会提示你检测到了已存在的 Git 配置Sourcetree 会询问是否使用系统 Git 还是它内置的 Git。我个人的建议是使用 Sourcetree 内置的 Git因为版本经过适配不容易出现兼容问题。安装结束后首次启动会进入欢迎页。这里有一步是添加 Atlassian 账号很多新人会卡在这。其实这一步不是必须的你完全可以直接跳过账号登录因为后续我们会用 SSH 密钥和 Gitee 关联并不依赖 Atlassian 账号体系。2.3 首次启动时如何跳过 Atlassian 账号登录很多 Sourcetree 教程都在 Atlassian 账号这一步翻车导致软件无法顺利进入主界面。实际上Atlassian 在后续的版本中已经考虑到了用户需要跳过的情况。在首次启动界面你会看到“使用 Atlassian 账号登录”的按钮。如果你不想注册 Atlassian 账号可以点击右上角的“在 Atlassian 之外使用”然后继续。如果没看到这个选项你可以直接关闭登录弹窗选择“未安装”或“跳过”之类的选项。还有一种办法断网状态下启动 Sourcetree它无法连接 Atlassian 服务器就会让你进入离线模式。但这种方法不太推荐因为你后续还要连接 Gitee。我实测最稳妥的方法是点击页面底部的“下一步”或者“跳过”系统会提示“你没有登录 Atlassian 账号不影响使用”直接确认就进入主界面了。主界面看到后Sourcetree 会做一个初始配置比如询问你的姓名和邮箱。这里填写的信息会作为本地 Git 提交的作者信息建议填写你在 Gitee 上绑定的邮箱这样提交记录才能正确关联到你的 Gitee 账号。3. 身份验证SSH 密钥的生成与配置全攻略3.1 为什么 SSH 密钥的生成方式值得看一下身份验证是整个流程里最容易出问题的地方。Gitee 支持 HTTPS 和 SSH 两种仓库访问协议两者的区别我已经说过。SSH 密钥认证的关键在于你的电脑需要有一对密钥——一个私钥自己保存、一个公钥放到 Gitee 上。当 Sourcetree 发起连接时Gitee 会用公钥验证你的身份整个过程不输密码安全又顺滑。使用 Sourcetree 内建的 Git配合 SSH 密钥只要 Sourcetree 能读取到私钥其他事情都不需要你操心。Sourcetree 内置了 OpenSSH支持自动识别常见位置的密钥文件比如~/.ssh/id_rsa和~/.ssh/id_ed25519所以只要你建立了密钥并添加到 Gitee它就能正常使用。3.2 在 Windows 上用命令生成 SSH 密钥的两种方法生成 SSH 密钥有两种方式一种是用 Git Bash 或终端命令行另一种是靠工具。我推荐命令行方式因为它是行业标准做法而且生成之后你能很清楚密钥存放在哪里。方法一使用 Git Bash 生成如果你安装了 Git for Windows在桌面右键选择“Git Bash Here”输入以下命令ssh-keygen -t rsa -b 4096 -C 你的Gitee邮箱这里的-C参数是一个注释用来说明这个密钥的归属方便以后在多个密钥的情况下分辨。接着终端会问你“Enter file in which to save the key”默认路径是/c/Users/你的用户名/.ssh/id_rsa直接回车使用默认即可。然后系统会询问你是否为私钥设置口令passphrase我建议设置一个因为这是额外的安全层。注意这里的口令不是 Gitee 密码而是保护你私钥文件的本地密码每次 Sourcetree 使用私钥时可能要输入一次。方法二使用 PowerShell 生成ssh-keygen -t ed25519 -C 你的Gitee邮箱PowerShell 生成的密钥默认存放在C:\Users\你的用户名\.ssh\目录下文件名是id_ed25519。无论哪种方式生成完成后你会得到两个文件私钥id_rsa或id_ed25519绝密留在本地。公钥id_rsa.pub或id_ed25519.pub可以给别人或平台。还有一个小技巧可以确认生成是否成功ls ~/.ssh你会看到列出的两个文件就说明密钥生成成功了。3.3 如何把公钥正确配置到 Gitee 上生成公钥之后你需要把公钥的内容复制出来放到 Gitee 的 SSH 公钥管理页面。推荐使用下面的命令查看公钥内容cat ~/.ssh/id_ed25519.pub复制输出的整行内容以ssh-ed25519或ssh-rsa开头结尾一般是你的邮箱。注意不要漏掉任何字符末尾的换行符不要复制进去。接着登录 Gitee点击头像 - 设置 - 安全设置 - SSH 公钥。这个页面的标题通常是“SSH 公钥管理”。把复制的内容粘贴到公钥输入框给这个公钥起一个名字比如“我的 Windows 电脑”或者“公司笔记本”方便以后区分。点击“确定”就完成了。整个流程的一个关键提醒公钥千万不要和私钥搞混。公钥是可以公开的私钥绝对不能泄露。如果你不小心把私钥发给了别人等于把你的电脑访问权限交给了别人非常危险。3.4 配置完 SSH 后怎么测试连通性配置好公钥后可以通过下面的命令测试连接ssh -T gitgitee.com第一次输入该命令时可能会提示“Are you sure you want to continue connecting”输入yes回车即可。如果配置成功你会看到欢迎语通常提示你的用户名或“你已经认证到 Gitee”。如果你看到Permission denied (publickey)的报错说明 Sourcetree 或者系统找不到合适的私钥。排查方向有三个检查公钥是否完整粘贴到了 Gitee。检查私钥是否存在且路径正确。确认当前用户环境是否正确。3.5 使用 HTTPS 方式时的密码和私有令牌说明如果你不想用 SSH也可以选择 HTTPS 方式。这种方式下Sourcetree 在克隆仓库时会让你输入 Gitee 的用户名和密码。这里有个容易踩的坑如果你的 Gitee 账号开启了两步验证MFA那么密码处要填的是私有令牌而不是登录密码。私有令牌的生成位置Gitee - 设置 - 安全设置 - 私人令牌。点击生成给令牌起个名字设置有效期复制生成的令牌字符串然后在使用 HTTPS 克隆时密码处粘贴这个令牌。这个令牌只会显示一次关闭页面后就看不到了一定要先保存好。3.6 SSH 配置时容易出现的问题以及排查思路我梳理了一些身份验证时会遇到的问题这些坑我都踩过问题现象可能原因解决方案提示Permission denied (publickey)公钥未正确添加到 Gitee重新复制公钥确认 Gitee 上的内容和本机id_ed25519.pub一致提示“连接超时”或“无法解析主机”网络不通或端口被防火墙拦截确认能访问 Gitee 官网如果是公司网络检查 22 端口是否被禁必要时切换 SSH 端口为 443Sourcetree 推送时报“认证失败”私钥未加载或 Sourcetree 找不到私钥确认私钥文件存在路径在~/.ssh/在 Sourcetree 设置中指定 SSH 客户端为 OpenSSH使用 HTTPS 时提示密码错误开启了双重验证却用了账号密码使用私人令牌作为密码还有一个冷门问题如果本机存在多个 SSH 密钥Sourcetree 可能用错密钥导致认证失败。这时候你需要在~/.ssh/目录下创建一个config文件指明 Gitee 使用哪个特定的私钥。例如Host gitee.com HostName gitee.com User git IdentityFile ~/.ssh/id_ed25519这个配置文件解决了多密钥场景下的选择难题。4. 从重置到推送用 Sourcetree 操作 Gitee 仓库的完整过程4.1 在 Gitee 上创建仓库时要注意什么在开始使用 Sourcetree 操作 Gitee 之前需要在 Gitee 网页端创建一个仓库。登录 Gitee点击右上角的“”号选择“新建仓库”。填写仓库名称这个名称会作为 Git 仓库的名字建议用英文和连字符避免使用中文和空格。然后你会看到仓库的“路径”字段系统会自动根据仓库名生成这也是远程仓库 URL 的一部分。接下来是是否初始化仓库的选项不要勾选“初始化仓库”。如果你希望立刻在本地用 Sourcetree 初始化并提交代码那么保持空白仓库状态克隆或关联时会少很多麻烦。如果你勾选了“使用 Readme 文件初始化这个仓库”那么 Gitee 上会生成一个包含README.md和.gitignore的初始提交。然后你再本地关联并推送时就需要先拉取一次远程仓库的提交或者使用git pull --rebase合并否则推送会被拒绝。我个人的习惯是创建仓库时保持空白等本地内容准备好后第一次推送。还有几个选项值得一提私有只允许自己和指定的协作者访问推荐默认勾选。开源许可证如果你计划开源选一个合适的 License比如 MIT、Apache 2.0如果不确定选 MIT 比较宽松。分支模型Gitee 默认创建master分支。如果你想让仓库默认分支是main可以创建后修改默认分支设置。但我建议跟随平台默认省去麻烦。.gitignore勾选后 Gitee 会自动生成一个适用于主流语言的忽略文件。如果你已经在本地建好.gitignore就取消勾选避免冲突。4.2 Sourcetree 克隆 Gitee 仓库的操作方法创建完仓库后进入仓库主页点击“克隆/下载”按钮可以选择 SSH 或 HTTPS 链接。如果使用 SSH链接类似gitgitee.com:你的用户名/仓库名.git复制这串链接。现在打开 Sourcetree点击菜单栏的“克隆”按钮。在弹出的窗口里源 URL粘贴刚复制的链接。目标路径选择你本机保存代码的目录。克隆名称Sourcetree 会自动根据仓库名生成一般不用改。点击“克隆”按钮。如果 SSH 配置正确Sourcetree 会开始拉取远程仓库的内容到本地整个过程可视几秒钟到几分钟不等。完成之后左侧会多出这个仓库的条目双击即可进入仓库主界面。4.3 初始化本地项目并与 Gitee 仓库关联如果你已经有了现成的本地项目想要推送到 Gitee有两种方式。方式一本地已用 Git 初始化如果你已经执行过git init那么只需要在 Sourcetree 里打开这个本地仓库然后在仓库设置里添加远程仓库地址。点击 Sourcetree 的“仓库”菜单选择“仓库设置”在“远程”选项卡中点击“添加”填入远程仓库 URL 和远程仓库名一般是origin保存即可。方式二本地完全没有 Git 概念如果你只是写代码从没有初始化的概念那么在 Sourcetree 中选择“文件 - 打开”选中你的项目文件夹Sourcetree 会检测到它不是 Git 仓库并询问是否初始化。点击“创建”即可。然后执行方式一的添加远程仓库操作。4.4 本地提交与远程推送的流程演示假设你已经在本地修改了一个文件比如README.md。Sourcetree 主界面的“文件状态”标签页会显示这个文件的改动列表。你要做的是在文件列表里勾选要暂存的文件通常是所有改动文件点击“全部暂存”按钮。在底部输入提交信息这是个必填项建议写清楚本次改动的目的。比如“初始化项目文件”。点击“提交”按钮本地就生成了一次提交。点击顶部工具栏的“推送”按钮弹出推送对话框。确认推送到origin的master分支或者你当前所在的分支点击“推送”。推送成功后你在 Gitee 网页端刷新页面就能看到刚刚提交的代码了。这里有个非常重要的细节提交是本地操作推送才是上传远程。很多新手混淆这两个动作以为提交了代码就万事大吉结果远程仓库一直没更新。记住提交是把改动固定到本地 Git 历史推送是同步到远程 Gitee。4.5 推送被拒绝怎么办在推送时最可能遇到的情况是“推送被拒绝”。这往往是因为远程仓库有本地没有的提交比如你在 Gitee 网页端点了添加README.md然后本地又提交了新文件现在本地和远程的代码历史分支分叉了。有两种解决思路先拉取远程代码再推送。Sourcetree 点击“拉取”按钮选择对应的远程分支Sourcetree 会尝试合并远程分支到本地分支。如果合并没有冲突之后就能正常推送。使用“强制推送”。这个操作会覆盖远程仓库的历史非常危险不推荐使用尤其是团队协作场景会导致别人的提交丢失。正确的做法是使用拉取Pull而不是强制推送。如果你的本地代码和远程代码确实有冲突Sourcetree 会提示冲突文件你需要手动解决冲突后再提交、再推送。5. 日常开发中的高频实操分支、拉取与贮藏5.1 分支的管理能够避免很多无谓的错误用 Sourcetree 管理分支很简单点击顶部工具栏的“分支”按钮输入新的分支名称基于当前分支创建新分支。创建之后Sourcetree 会自动切换到这个新分支上意味着你接下来的提交都会出现在这个新分支上。为什么分支管理这么重要因为主分支master或main应该始终保持可发布的状态。你开发新功能时在新分支上随便折腾不影响主分支的稳定。功能完成后再把新分支合并回主分支。Sourcetree 的图形化分支图让我非常直观地看到每个分支的走向避免了自己在命令行里操作时“不知道当前在哪个分支”的窘境。5.2 拉取Pull与冲突解决的问题拉取操作其实是两件事的组合先从远程抓取最新数据Fetch然后将远程分支合并到当前分支Merge。Sourcetree 的“拉取”按钮整合了这两步。当你拉取时如果远程分支和本地分支有冲突Sourcetree 会列出冲突文件。你需要打开这些文件手动编辑保留你想要的代码内容。解决完冲突后在 Sourcetree 的文件状态里标记冲突已解决通常是点击“标记已解决”然后提交合并结果。我以前总怕冲突后来发现其实冲突没那么可怕。用图形化工具反而更明白因为你可以在 Sourcetree 里看到ours当前分支的版本和theirs远程分支的版本两种版本合并取舍更清晰。Sourcetree 的合并冲突解决界面会让两边代码并排显示你可以逐段决定保留哪边。5.3 贮藏Stash功能临时保存工作现场这个功能我强烈推荐太实用了。当你正在开发一个功能代码写到一半但突然需要切换到别的分支修一个紧急 Bug你不想提交不完整的代码怎么办贮藏就是为这个场景设计的。在 Sourcetree 中点击“贮藏”按钮输入一个标识性的备注比如“用户登录功能开发中”当前未提交的改动就会被临时保存起来工作区恢复到干净状态。这时你可以放心地切换到其他分支。等你处理完紧急 Bug回来继续开发时点击 Sourcetree 的“贮藏”下拉菜单选择“应用贮藏”你之前未完成的改动就会重新恢复到工作区继续开发即可。5.4 多仓库在 Sourcetree 中的统一管理Sourcetree 除了单仓库操作还可以让你维护多个仓库。左侧的仓库列表会显示你本地添加过的所有仓库点击即可切换。如果你想添加一个新仓库点击“文件 - 打开”或者“克隆”一个新仓库之后它就会出现在列表里。这种统一管理的方式挺方便尤其是我在工作中需要频繁切换项目的场景。你不用像命令行那样每次cd到不同目录。5.5 SoureceTree 的“工作流”小发现Sourcetree 在后期版本中加入了“工作流”表单功能但它更多的还是偏向 Git Flow 的分支模型支持。你可以通过初始化 Git Flow让 Sourcetree 自动为feature/*、release/*、hotfix/*等分支分组搭好一套标准的研发协作流。如果你是一个小团队用 Sourcetree 的 Git Flow 插件能少走很多弯路因为它把标准的合并操作都简化成按钮你不用记git flow feature start之类的命令。6. 常见问题与排查技巧实录6.1 身份验证和推送失败的典型问题汇总做完了整个全流程我把高频问题整理成一张速查表遇到红字报错直接对号入座能省下大量搜索时间。问题现象原因解决方法fatal: Authentication failed私钥/密码错误或凭证过期检查 SSH 公钥是否在 Gitee 正确绑定HTTPS 方式改用私有令牌fatal: Unable to access ... Failed to connect to gitee.com port 443网络不通或代理配置错误检查代理设置或在 Git 中正确配置代理Permission denied (publickey)公钥未配置或多个密钥导致的识别问题确认id_ed25519.pub内容已粘贴到 Gitee创建~/.ssh/config明确指定密钥Updates were rejected because the remote contains work远程有本地没有的提交先拉取Pull再推送或让远程和本地合并到同步状态Your branch and origin/master have diverged本地和远程都有各自的提交执行git pull --rebase或手动合并冲突HTTP 方式推送时提示“需要密码”但找不到输入框Sourcetree 无法弹出认证窗口在 Gitee 设置中生成私有令牌并填入 Sourcetree 的凭证管理器6.2 从库里看到的“身份验证”报错具体怎么解“身份验证错误”在 Sourcetree 里说得比较宽泛但最常见的就是密码错误或者权限不足。举个例子你在 Sourcetree 里用 HTTPS 克隆仓库时弹窗让你输账号密码。你输了自己的 Gitee 登录密码如果开启了双重验证它必然报错。这时候你应该生成一个私有令牌把令牌作为密码。还有一个冷门情况Windows 的“凭据管理器”里存储了旧的密码。即便你修改了 Gitee 密码Sourcetree 依然会用旧的凭据去连接。解决方法是打开 Windows 控制面板 - 用户账户 - 凭据管理器找到git:https://gitee.com的记录删除后重新推送再认证一次。6.3 多次推送失败后试一下强制推送值得吗我向来不建议强制推送但在单人开发并且远程分支不重要的情况下它是快速解决同步问题的备选方案。强制推送的命令在 Sourcetree 里也有就在推送对话框的选项里勾选“强制推送”即可。但是要记住强制推送会覆盖远程分支的提交历史如果你和别人协作他们的本地提交可能会因此消失。所以不到万不得已不要强制推送。如果有同事和你共用这个分支请先沟通。6.4 关于 .gitignore 的坑还有一个高频问题为什么我把某个文件加入了.gitignoreSourcetree 里还是能看到它的改动原因通常是这个文件在.gitignore生效之前就已经被 Git 跟踪track了。你需要将其从 Git 跟踪中移除。在 Sourcetree 中你可以右键文件选择“终止跟踪Delete”然后把改动提交一次。之后这个文件才会真正被 Git 忽略。这个操作在当前分支上有效其他分支如果有该文件的跟踪记录还需要额外处理。6.5 无法克隆 Gitee 私有仓库的排查流程私有仓库的克隆权限只对仓库成员或拥有者开放。如果你用非拥有者的账号去克隆私有仓库哪怕 SSH 密钥正确也会报“仓库不存在”或“权限不足”。这时候你需要确认是否已经加入该仓库的成员列表仓库设置 - 成员管理。确认你的 SSH 公钥已经添加到该账号的 Gitee 设置中。确认 SSH 测试连接时显示的用户名和该仓库管理员邀请的用户名一致。6.6 推荐几个配合 Sourcetree 使用的小工具Sourcetree 虽然功能强大但有些场景我习惯搭配其他小工具来提升效率。VS Code装了 Gitee 插件后可以在编辑器里直接查看 Pull Request、创建 Gist 等。配合 Sourcetree 的图形界面一个管写代码一个管版本控制。Beyond CompareSourcetree 内置了文件比较功能但 Beyond Compare 在解决复杂冲突时表现更强。Sourcetree 自身的“AI 提交信息”较新版本加入了 AI 生成提交信息的功能如果启用了写提交信息能省不少事你可以试试。7. 给新手的一些补充建议7.1 保持主分支的干净无论是在 Sourcetree 还是命令行里保持master或main分支随时处于可部署状态都是好习惯。改代码时新建功能分支开发完合并回来。Sourcetree 的“Git Flow”功能就是为这个目标设计的值得好好利用。7.2 提交信息要写清楚提交信息不是给 Git 看的是给人看的。三个月后你回来看自己的提交如果全是“f**”之类的模糊信息你会想抽自己。我的建议是提交信息的第一行用一句话概括本次改动比如“修复用户登录时验证码过期问题”如果有必要空一行再补充详情。7.3 定期拉取远程代码团队协作时远程代码会频繁更新。我习惯每天早上一到公司就拉取一次主分支代码避免本地分支和远程分支差距过大减少冲突概率。Sourcetree 的拉取操作很简单甚至可以配置为打开仓库时自动拉取省去手动操作。7.4 不要把大文件提交到 GitGit 不适合存放大体积文件比如视频、模型文件、二进制包它们会让仓库体积迅速膨胀导致克隆和拉取越来越慢。如果需要存放这类文件建议使用 Gitee 的“发行版”功能或者独立的文件存储服务而不是塞进 Git 仓库。7.5 留意 Gitee 的仓库容量限制Gitee 对仓库大小有配额限制具体数值以官网说明为准。达到上限后推送会失败。遇到这种问题最好的做法是清理仓库中的大文件历史或者使用 Git LFS大文件存储来管理大文件。Sourcetree 对 Git LFS 有内建支持你可以在仓库设置中开启 LFS 跟踪。8. 一些碎碎念整套流程走下来你会发现 Sourcetree 和 Gitee 的组合其实非常顺手。Sourcetree 负责把 Git 的操作从“背命令”变成“看图形”大大降低了心智负担Gitee 作为国内托管平台速度和服务都能到位。我最享受的就是配好 SSH 后那种“无感推送”的体验写完代码点一下推送剩下的事情交给它。如果你之前一直卡在身份验证或者推送失败的过程中希望这篇文章能把你的路铺平。配置 SSH 密钥看似麻烦但一旦配好后续都是丝滑操作。我个人在实际操作中还有一个体会一定要保存好私钥重装系统后需要通过私钥重新配置 Sourcetree否则会陷入一遍遍重新认证的轮回。最后再分享一个小技巧如果你的 Sourcetree 偶尔出现界面卡顿可以尝试关闭仓库窗口再重新打开或者去“工具 - 选项”里调整 Git 版本。绝大多数小毛病都能靠重启解决这不是玩笑。 Sourcetree搭配Gitee：SSH配置与图形化推送实战指南
写代码这些年Git 几乎是绕不开的日常工具但命令行那一堆指令对不熟悉终端的人来说确实不友好。我见过太多同事在git push时被权限问题卡住或者在合并分支时对着终端一脸茫然。后来我慢慢转向 Sourcetree Gitee 这套组合发现它既能满足图形化操作的需求又能很好地融入国内的代码托管生态从身份验证到推送成功整个流程捋顺之后效率提升非常明显。这篇东西不是官方文档的翻译而是把我自己从安装、踩坑到最终顺畅推送的完整过程记录下来。无论你是刚接触 Git 的新手还是习惯命令行但想找个 GUI 工具辅助的老手这篇文章应该都能帮你省下不少时间。我会把身份验证、仓库关联、推送流程这些容易出问题的环节掰开揉碎地讲清楚尽量让你照着做就能跑通。1. 为什么选 Sourcetree 搭配 Gitee这套组合好在哪1.1 Sourcetree 能解决什么问题Sourcetree 是 Atlassian 推出的免费 Git 图形化客户端它解决的问题非常直接把 Git 的复杂操作变成可视化点击。你要知道Git 的命令行工具虽然强大但对人类记忆的负担实在太大——git rebase、git cherry-pick、git reset --hard这些指令光靠记忆很容易出错尤其在分支多、提交频繁的项目里。Sourcetree 的最大优势是“所见即所得”。提交历史以图形化界面展示分支的走向一目了然点击按钮就能完成暂存、提交、推送、拉取、合并等操作。我刚开始用它的时候最大的感受就是心里有底了。你知道自己当前在哪个分支知道本地和远程的差距是多少个提交不会因为敲错命令导致不可挽回的后果。另外Sourcetree 内置了 Diff 对比工具你可以直观地看到每一行代码的改动这比在终端里看密密麻麻的文本输出舒服太多。对于代码审查或者自己检查改动这个功能非常实用。1.2 为什么选择 Gitee 而不是其他平台Gitee码云是国内发展的代码托管平台对国内开发者来说有几个非常现实的优势。首先是速度快服务器在国内无论克隆还是推送都比访问境外平台稳定得多尤其是在网络环境波动的时候这个体验差异是巨大的。其次是 Gitee 的私有仓库免费。对于个人项目和中小企业来说这省下了一笔不小的费用。它的团队协作功能也够用比如 Pull Request、Issue 管理、Wiki 文档等基本满足日常研发流程的需要。Gitee 还支持一键导入 GitHub 仓库如果你之前在 GitHub 上有开源项目可以方便地迁移过来。还有一个很重要的点是Gitee 的文档和界面都是中文的对于英语不太熟练的开发者非常友好。它甚至有 Gitee 的桌面端和小程序方便你随时随地查看动态、处理 Issue。1.3 为什么推荐“SSH 密钥 Sourcetree”的组合我用过 HTTPS 方式配合 Sourcetree 连接 Gitee也用过 SSH 方式最终稳定下来的方案是“SSH 密钥认证 Sourcetree 操作”。核心原因是SSH 密钥不需要每次推送都输入密码而且更安全。使用 HTTPS 协议时如果你开启了两步验证或者频繁切换账号每次推送都可能被要求输入用户名和密码甚至需要使用私有令牌替代密码这在日常操作中相当打断节奏。SSH 方式通过公钥加密认证一旦配置好Sourcetree 就能自动识别密钥免密推送体验顺畅很多。当然SSH 也有一个初期门槛你得会生成密钥、配置公钥到 Gitee、让 Sourcetree 找到私钥。这个过程第一次做会觉得麻烦但配好之后一劳永逸。我会在后面的章节详细演示这一步。2. 环境准备安装 Sourcetree、Git 与 Gitee 账号2.1 安装前的必要准备在安装 Sourcetree 之前你至少需要准备以下内容一个 Gitee 账号。访问 Gitee 官网 注册即可手机号或者邮箱都能注册建议绑定手机号方便找回密码。Windows 或 macOS 系统。Sourcetree 对这两个系统都有对应的版本。确保本机网络可以正常访问 Gitee如果处于公司内网环境要注意网络策略是否限制 SSH 端口默认是 22。如果你已经装了 Git 命令行工具可以留着如果没装Sourcetree 安装时通常会自动配置内部的 Git不需要额外操心。这里有个容易忽略的点Sourcetree 依赖 Git 核心。如果你本机没有任何 Git 环境首次启动 Sourcetree 时它会提示安装内置的 Git 版本。我建议你允许它这样做因为 Sourcetree 内置的 Git 已经过测试兼容性最有保障。2.2 从下载到安装的完整步骤Sourcetree 的下载地址是 Atlassian 官网根据你的操作系统选择对应安装包。下载完成后双击安装文件基本一路 Next 就能完成安装。但有几个细节需要注意如果你已经装了 Git安装时可能会提示你检测到了已存在的 Git 配置Sourcetree 会询问是否使用系统 Git 还是它内置的 Git。我个人的建议是使用 Sourcetree 内置的 Git因为版本经过适配不容易出现兼容问题。安装结束后首次启动会进入欢迎页。这里有一步是添加 Atlassian 账号很多新人会卡在这。其实这一步不是必须的你完全可以直接跳过账号登录因为后续我们会用 SSH 密钥和 Gitee 关联并不依赖 Atlassian 账号体系。2.3 首次启动时如何跳过 Atlassian 账号登录很多 Sourcetree 教程都在 Atlassian 账号这一步翻车导致软件无法顺利进入主界面。实际上Atlassian 在后续的版本中已经考虑到了用户需要跳过的情况。在首次启动界面你会看到“使用 Atlassian 账号登录”的按钮。如果你不想注册 Atlassian 账号可以点击右上角的“在 Atlassian 之外使用”然后继续。如果没看到这个选项你可以直接关闭登录弹窗选择“未安装”或“跳过”之类的选项。还有一种办法断网状态下启动 Sourcetree它无法连接 Atlassian 服务器就会让你进入离线模式。但这种方法不太推荐因为你后续还要连接 Gitee。我实测最稳妥的方法是点击页面底部的“下一步”或者“跳过”系统会提示“你没有登录 Atlassian 账号不影响使用”直接确认就进入主界面了。主界面看到后Sourcetree 会做一个初始配置比如询问你的姓名和邮箱。这里填写的信息会作为本地 Git 提交的作者信息建议填写你在 Gitee 上绑定的邮箱这样提交记录才能正确关联到你的 Gitee 账号。3. 身份验证SSH 密钥的生成与配置全攻略3.1 为什么 SSH 密钥的生成方式值得看一下身份验证是整个流程里最容易出问题的地方。Gitee 支持 HTTPS 和 SSH 两种仓库访问协议两者的区别我已经说过。SSH 密钥认证的关键在于你的电脑需要有一对密钥——一个私钥自己保存、一个公钥放到 Gitee 上。当 Sourcetree 发起连接时Gitee 会用公钥验证你的身份整个过程不输密码安全又顺滑。使用 Sourcetree 内建的 Git配合 SSH 密钥只要 Sourcetree 能读取到私钥其他事情都不需要你操心。Sourcetree 内置了 OpenSSH支持自动识别常见位置的密钥文件比如~/.ssh/id_rsa和~/.ssh/id_ed25519所以只要你建立了密钥并添加到 Gitee它就能正常使用。3.2 在 Windows 上用命令生成 SSH 密钥的两种方法生成 SSH 密钥有两种方式一种是用 Git Bash 或终端命令行另一种是靠工具。我推荐命令行方式因为它是行业标准做法而且生成之后你能很清楚密钥存放在哪里。方法一使用 Git Bash 生成如果你安装了 Git for Windows在桌面右键选择“Git Bash Here”输入以下命令ssh-keygen -t rsa -b 4096 -C 你的Gitee邮箱这里的-C参数是一个注释用来说明这个密钥的归属方便以后在多个密钥的情况下分辨。接着终端会问你“Enter file in which to save the key”默认路径是/c/Users/你的用户名/.ssh/id_rsa直接回车使用默认即可。然后系统会询问你是否为私钥设置口令passphrase我建议设置一个因为这是额外的安全层。注意这里的口令不是 Gitee 密码而是保护你私钥文件的本地密码每次 Sourcetree 使用私钥时可能要输入一次。方法二使用 PowerShell 生成ssh-keygen -t ed25519 -C 你的Gitee邮箱PowerShell 生成的密钥默认存放在C:\Users\你的用户名\.ssh\目录下文件名是id_ed25519。无论哪种方式生成完成后你会得到两个文件私钥id_rsa或id_ed25519绝密留在本地。公钥id_rsa.pub或id_ed25519.pub可以给别人或平台。还有一个小技巧可以确认生成是否成功ls ~/.ssh你会看到列出的两个文件就说明密钥生成成功了。3.3 如何把公钥正确配置到 Gitee 上生成公钥之后你需要把公钥的内容复制出来放到 Gitee 的 SSH 公钥管理页面。推荐使用下面的命令查看公钥内容cat ~/.ssh/id_ed25519.pub复制输出的整行内容以ssh-ed25519或ssh-rsa开头结尾一般是你的邮箱。注意不要漏掉任何字符末尾的换行符不要复制进去。接着登录 Gitee点击头像 - 设置 - 安全设置 - SSH 公钥。这个页面的标题通常是“SSH 公钥管理”。把复制的内容粘贴到公钥输入框给这个公钥起一个名字比如“我的 Windows 电脑”或者“公司笔记本”方便以后区分。点击“确定”就完成了。整个流程的一个关键提醒公钥千万不要和私钥搞混。公钥是可以公开的私钥绝对不能泄露。如果你不小心把私钥发给了别人等于把你的电脑访问权限交给了别人非常危险。3.4 配置完 SSH 后怎么测试连通性配置好公钥后可以通过下面的命令测试连接ssh -T gitgitee.com第一次输入该命令时可能会提示“Are you sure you want to continue connecting”输入yes回车即可。如果配置成功你会看到欢迎语通常提示你的用户名或“你已经认证到 Gitee”。如果你看到Permission denied (publickey)的报错说明 Sourcetree 或者系统找不到合适的私钥。排查方向有三个检查公钥是否完整粘贴到了 Gitee。检查私钥是否存在且路径正确。确认当前用户环境是否正确。3.5 使用 HTTPS 方式时的密码和私有令牌说明如果你不想用 SSH也可以选择 HTTPS 方式。这种方式下Sourcetree 在克隆仓库时会让你输入 Gitee 的用户名和密码。这里有个容易踩的坑如果你的 Gitee 账号开启了两步验证MFA那么密码处要填的是私有令牌而不是登录密码。私有令牌的生成位置Gitee - 设置 - 安全设置 - 私人令牌。点击生成给令牌起个名字设置有效期复制生成的令牌字符串然后在使用 HTTPS 克隆时密码处粘贴这个令牌。这个令牌只会显示一次关闭页面后就看不到了一定要先保存好。3.6 SSH 配置时容易出现的问题以及排查思路我梳理了一些身份验证时会遇到的问题这些坑我都踩过问题现象可能原因解决方案提示Permission denied (publickey)公钥未正确添加到 Gitee重新复制公钥确认 Gitee 上的内容和本机id_ed25519.pub一致提示“连接超时”或“无法解析主机”网络不通或端口被防火墙拦截确认能访问 Gitee 官网如果是公司网络检查 22 端口是否被禁必要时切换 SSH 端口为 443Sourcetree 推送时报“认证失败”私钥未加载或 Sourcetree 找不到私钥确认私钥文件存在路径在~/.ssh/在 Sourcetree 设置中指定 SSH 客户端为 OpenSSH使用 HTTPS 时提示密码错误开启了双重验证却用了账号密码使用私人令牌作为密码还有一个冷门问题如果本机存在多个 SSH 密钥Sourcetree 可能用错密钥导致认证失败。这时候你需要在~/.ssh/目录下创建一个config文件指明 Gitee 使用哪个特定的私钥。例如Host gitee.com HostName gitee.com User git IdentityFile ~/.ssh/id_ed25519这个配置文件解决了多密钥场景下的选择难题。4. 从重置到推送用 Sourcetree 操作 Gitee 仓库的完整过程4.1 在 Gitee 上创建仓库时要注意什么在开始使用 Sourcetree 操作 Gitee 之前需要在 Gitee 网页端创建一个仓库。登录 Gitee点击右上角的“”号选择“新建仓库”。填写仓库名称这个名称会作为 Git 仓库的名字建议用英文和连字符避免使用中文和空格。然后你会看到仓库的“路径”字段系统会自动根据仓库名生成这也是远程仓库 URL 的一部分。接下来是是否初始化仓库的选项不要勾选“初始化仓库”。如果你希望立刻在本地用 Sourcetree 初始化并提交代码那么保持空白仓库状态克隆或关联时会少很多麻烦。如果你勾选了“使用 Readme 文件初始化这个仓库”那么 Gitee 上会生成一个包含README.md和.gitignore的初始提交。然后你再本地关联并推送时就需要先拉取一次远程仓库的提交或者使用git pull --rebase合并否则推送会被拒绝。我个人的习惯是创建仓库时保持空白等本地内容准备好后第一次推送。还有几个选项值得一提私有只允许自己和指定的协作者访问推荐默认勾选。开源许可证如果你计划开源选一个合适的 License比如 MIT、Apache 2.0如果不确定选 MIT 比较宽松。分支模型Gitee 默认创建master分支。如果你想让仓库默认分支是main可以创建后修改默认分支设置。但我建议跟随平台默认省去麻烦。.gitignore勾选后 Gitee 会自动生成一个适用于主流语言的忽略文件。如果你已经在本地建好.gitignore就取消勾选避免冲突。4.2 Sourcetree 克隆 Gitee 仓库的操作方法创建完仓库后进入仓库主页点击“克隆/下载”按钮可以选择 SSH 或 HTTPS 链接。如果使用 SSH链接类似gitgitee.com:你的用户名/仓库名.git复制这串链接。现在打开 Sourcetree点击菜单栏的“克隆”按钮。在弹出的窗口里源 URL粘贴刚复制的链接。目标路径选择你本机保存代码的目录。克隆名称Sourcetree 会自动根据仓库名生成一般不用改。点击“克隆”按钮。如果 SSH 配置正确Sourcetree 会开始拉取远程仓库的内容到本地整个过程可视几秒钟到几分钟不等。完成之后左侧会多出这个仓库的条目双击即可进入仓库主界面。4.3 初始化本地项目并与 Gitee 仓库关联如果你已经有了现成的本地项目想要推送到 Gitee有两种方式。方式一本地已用 Git 初始化如果你已经执行过git init那么只需要在 Sourcetree 里打开这个本地仓库然后在仓库设置里添加远程仓库地址。点击 Sourcetree 的“仓库”菜单选择“仓库设置”在“远程”选项卡中点击“添加”填入远程仓库 URL 和远程仓库名一般是origin保存即可。方式二本地完全没有 Git 概念如果你只是写代码从没有初始化的概念那么在 Sourcetree 中选择“文件 - 打开”选中你的项目文件夹Sourcetree 会检测到它不是 Git 仓库并询问是否初始化。点击“创建”即可。然后执行方式一的添加远程仓库操作。4.4 本地提交与远程推送的流程演示假设你已经在本地修改了一个文件比如README.md。Sourcetree 主界面的“文件状态”标签页会显示这个文件的改动列表。你要做的是在文件列表里勾选要暂存的文件通常是所有改动文件点击“全部暂存”按钮。在底部输入提交信息这是个必填项建议写清楚本次改动的目的。比如“初始化项目文件”。点击“提交”按钮本地就生成了一次提交。点击顶部工具栏的“推送”按钮弹出推送对话框。确认推送到origin的master分支或者你当前所在的分支点击“推送”。推送成功后你在 Gitee 网页端刷新页面就能看到刚刚提交的代码了。这里有个非常重要的细节提交是本地操作推送才是上传远程。很多新手混淆这两个动作以为提交了代码就万事大吉结果远程仓库一直没更新。记住提交是把改动固定到本地 Git 历史推送是同步到远程 Gitee。4.5 推送被拒绝怎么办在推送时最可能遇到的情况是“推送被拒绝”。这往往是因为远程仓库有本地没有的提交比如你在 Gitee 网页端点了添加README.md然后本地又提交了新文件现在本地和远程的代码历史分支分叉了。有两种解决思路先拉取远程代码再推送。Sourcetree 点击“拉取”按钮选择对应的远程分支Sourcetree 会尝试合并远程分支到本地分支。如果合并没有冲突之后就能正常推送。使用“强制推送”。这个操作会覆盖远程仓库的历史非常危险不推荐使用尤其是团队协作场景会导致别人的提交丢失。正确的做法是使用拉取Pull而不是强制推送。如果你的本地代码和远程代码确实有冲突Sourcetree 会提示冲突文件你需要手动解决冲突后再提交、再推送。5. 日常开发中的高频实操分支、拉取与贮藏5.1 分支的管理能够避免很多无谓的错误用 Sourcetree 管理分支很简单点击顶部工具栏的“分支”按钮输入新的分支名称基于当前分支创建新分支。创建之后Sourcetree 会自动切换到这个新分支上意味着你接下来的提交都会出现在这个新分支上。为什么分支管理这么重要因为主分支master或main应该始终保持可发布的状态。你开发新功能时在新分支上随便折腾不影响主分支的稳定。功能完成后再把新分支合并回主分支。Sourcetree 的图形化分支图让我非常直观地看到每个分支的走向避免了自己在命令行里操作时“不知道当前在哪个分支”的窘境。5.2 拉取Pull与冲突解决的问题拉取操作其实是两件事的组合先从远程抓取最新数据Fetch然后将远程分支合并到当前分支Merge。Sourcetree 的“拉取”按钮整合了这两步。当你拉取时如果远程分支和本地分支有冲突Sourcetree 会列出冲突文件。你需要打开这些文件手动编辑保留你想要的代码内容。解决完冲突后在 Sourcetree 的文件状态里标记冲突已解决通常是点击“标记已解决”然后提交合并结果。我以前总怕冲突后来发现其实冲突没那么可怕。用图形化工具反而更明白因为你可以在 Sourcetree 里看到ours当前分支的版本和theirs远程分支的版本两种版本合并取舍更清晰。Sourcetree 的合并冲突解决界面会让两边代码并排显示你可以逐段决定保留哪边。5.3 贮藏Stash功能临时保存工作现场这个功能我强烈推荐太实用了。当你正在开发一个功能代码写到一半但突然需要切换到别的分支修一个紧急 Bug你不想提交不完整的代码怎么办贮藏就是为这个场景设计的。在 Sourcetree 中点击“贮藏”按钮输入一个标识性的备注比如“用户登录功能开发中”当前未提交的改动就会被临时保存起来工作区恢复到干净状态。这时你可以放心地切换到其他分支。等你处理完紧急 Bug回来继续开发时点击 Sourcetree 的“贮藏”下拉菜单选择“应用贮藏”你之前未完成的改动就会重新恢复到工作区继续开发即可。5.4 多仓库在 Sourcetree 中的统一管理Sourcetree 除了单仓库操作还可以让你维护多个仓库。左侧的仓库列表会显示你本地添加过的所有仓库点击即可切换。如果你想添加一个新仓库点击“文件 - 打开”或者“克隆”一个新仓库之后它就会出现在列表里。这种统一管理的方式挺方便尤其是我在工作中需要频繁切换项目的场景。你不用像命令行那样每次cd到不同目录。5.5 SoureceTree 的“工作流”小发现Sourcetree 在后期版本中加入了“工作流”表单功能但它更多的还是偏向 Git Flow 的分支模型支持。你可以通过初始化 Git Flow让 Sourcetree 自动为feature/*、release/*、hotfix/*等分支分组搭好一套标准的研发协作流。如果你是一个小团队用 Sourcetree 的 Git Flow 插件能少走很多弯路因为它把标准的合并操作都简化成按钮你不用记git flow feature start之类的命令。6. 常见问题与排查技巧实录6.1 身份验证和推送失败的典型问题汇总做完了整个全流程我把高频问题整理成一张速查表遇到红字报错直接对号入座能省下大量搜索时间。问题现象原因解决方法fatal: Authentication failed私钥/密码错误或凭证过期检查 SSH 公钥是否在 Gitee 正确绑定HTTPS 方式改用私有令牌fatal: Unable to access ... Failed to connect to gitee.com port 443网络不通或代理配置错误检查代理设置或在 Git 中正确配置代理Permission denied (publickey)公钥未配置或多个密钥导致的识别问题确认id_ed25519.pub内容已粘贴到 Gitee创建~/.ssh/config明确指定密钥Updates were rejected because the remote contains work远程有本地没有的提交先拉取Pull再推送或让远程和本地合并到同步状态Your branch and origin/master have diverged本地和远程都有各自的提交执行git pull --rebase或手动合并冲突HTTP 方式推送时提示“需要密码”但找不到输入框Sourcetree 无法弹出认证窗口在 Gitee 设置中生成私有令牌并填入 Sourcetree 的凭证管理器6.2 从库里看到的“身份验证”报错具体怎么解“身份验证错误”在 Sourcetree 里说得比较宽泛但最常见的就是密码错误或者权限不足。举个例子你在 Sourcetree 里用 HTTPS 克隆仓库时弹窗让你输账号密码。你输了自己的 Gitee 登录密码如果开启了双重验证它必然报错。这时候你应该生成一个私有令牌把令牌作为密码。还有一个冷门情况Windows 的“凭据管理器”里存储了旧的密码。即便你修改了 Gitee 密码Sourcetree 依然会用旧的凭据去连接。解决方法是打开 Windows 控制面板 - 用户账户 - 凭据管理器找到git:https://gitee.com的记录删除后重新推送再认证一次。6.3 多次推送失败后试一下强制推送值得吗我向来不建议强制推送但在单人开发并且远程分支不重要的情况下它是快速解决同步问题的备选方案。强制推送的命令在 Sourcetree 里也有就在推送对话框的选项里勾选“强制推送”即可。但是要记住强制推送会覆盖远程分支的提交历史如果你和别人协作他们的本地提交可能会因此消失。所以不到万不得已不要强制推送。如果有同事和你共用这个分支请先沟通。6.4 关于 .gitignore 的坑还有一个高频问题为什么我把某个文件加入了.gitignoreSourcetree 里还是能看到它的改动原因通常是这个文件在.gitignore生效之前就已经被 Git 跟踪track了。你需要将其从 Git 跟踪中移除。在 Sourcetree 中你可以右键文件选择“终止跟踪Delete”然后把改动提交一次。之后这个文件才会真正被 Git 忽略。这个操作在当前分支上有效其他分支如果有该文件的跟踪记录还需要额外处理。6.5 无法克隆 Gitee 私有仓库的排查流程私有仓库的克隆权限只对仓库成员或拥有者开放。如果你用非拥有者的账号去克隆私有仓库哪怕 SSH 密钥正确也会报“仓库不存在”或“权限不足”。这时候你需要确认是否已经加入该仓库的成员列表仓库设置 - 成员管理。确认你的 SSH 公钥已经添加到该账号的 Gitee 设置中。确认 SSH 测试连接时显示的用户名和该仓库管理员邀请的用户名一致。6.6 推荐几个配合 Sourcetree 使用的小工具Sourcetree 虽然功能强大但有些场景我习惯搭配其他小工具来提升效率。VS Code装了 Gitee 插件后可以在编辑器里直接查看 Pull Request、创建 Gist 等。配合 Sourcetree 的图形界面一个管写代码一个管版本控制。Beyond CompareSourcetree 内置了文件比较功能但 Beyond Compare 在解决复杂冲突时表现更强。Sourcetree 自身的“AI 提交信息”较新版本加入了 AI 生成提交信息的功能如果启用了写提交信息能省不少事你可以试试。7. 给新手的一些补充建议7.1 保持主分支的干净无论是在 Sourcetree 还是命令行里保持master或main分支随时处于可部署状态都是好习惯。改代码时新建功能分支开发完合并回来。Sourcetree 的“Git Flow”功能就是为这个目标设计的值得好好利用。7.2 提交信息要写清楚提交信息不是给 Git 看的是给人看的。三个月后你回来看自己的提交如果全是“f**”之类的模糊信息你会想抽自己。我的建议是提交信息的第一行用一句话概括本次改动比如“修复用户登录时验证码过期问题”如果有必要空一行再补充详情。7.3 定期拉取远程代码团队协作时远程代码会频繁更新。我习惯每天早上一到公司就拉取一次主分支代码避免本地分支和远程分支差距过大减少冲突概率。Sourcetree 的拉取操作很简单甚至可以配置为打开仓库时自动拉取省去手动操作。7.4 不要把大文件提交到 GitGit 不适合存放大体积文件比如视频、模型文件、二进制包它们会让仓库体积迅速膨胀导致克隆和拉取越来越慢。如果需要存放这类文件建议使用 Gitee 的“发行版”功能或者独立的文件存储服务而不是塞进 Git 仓库。7.5 留意 Gitee 的仓库容量限制Gitee 对仓库大小有配额限制具体数值以官网说明为准。达到上限后推送会失败。遇到这种问题最好的做法是清理仓库中的大文件历史或者使用 Git LFS大文件存储来管理大文件。Sourcetree 对 Git LFS 有内建支持你可以在仓库设置中开启 LFS 跟踪。8. 一些碎碎念整套流程走下来你会发现 Sourcetree 和 Gitee 的组合其实非常顺手。Sourcetree 负责把 Git 的操作从“背命令”变成“看图形”大大降低了心智负担Gitee 作为国内托管平台速度和服务都能到位。我最享受的就是配好 SSH 后那种“无感推送”的体验写完代码点一下推送剩下的事情交给它。如果你之前一直卡在身份验证或者推送失败的过程中希望这篇文章能把你的路铺平。配置 SSH 密钥看似麻烦但一旦配好后续都是丝滑操作。我个人在实际操作中还有一个体会一定要保存好私钥重装系统后需要通过私钥重新配置 Sourcetree否则会陷入一遍遍重新认证的轮回。最后再分享一个小技巧如果你的 Sourcetree 偶尔出现界面卡顿可以尝试关闭仓库窗口再重新打开或者去“工具 - 选项”里调整 Git 版本。绝大多数小毛病都能靠重启解决这不是玩笑。