简介：这份资源是面向 Windows 平台 Git 初学者的 TortoiseGit 图文使用教程，以 docx 文档形式系统梳理了从环境搭建到日常协作的完整流程，帮助不熟悉命令行的用户借助右键菜单快速上手版本控制。压缩包内共 1 个 docx 文件，约 1.15MB，内容涵盖 Git 与 TortoiseGit 及中文语言包的下载安装、General 与 Git 选项卡配置、用户名邮箱设置，以及通过 credential helper 保存凭证、生成并上传 SSH Key 等关键环节。教程还以克隆项目为例对比 HTTPS 与 SSH 两种连接方式，并讲解拉取、合并、提交、推送和分支管理等常用操作，同时说明文件状态角标的含义，便于读者对照排查问题。目前已有 2152 人学习，适合需要一份可随时查阅的入门操作手册的开发者参考。
1. 第一次用 Git 就懵了：命令行黑框框到底怎么下手
很多人第一次接触版本控制，是被同事或同学一句“你把代码提交一下”推进坑里的。打开教程一看，满屏的git add、git commit、git push，黑框框里敲错一个字母就报一堆英文，瞬间就不想学了。TortoiseGit 就是来解决这个尴尬的——它是 Windows 上的一个图形化 Git 工具，装好之后你在文件夹里点右键，就能看到“Git 提交”“Git 同步”“Git 克隆”这些中文菜单，不用背命令也能把代码管起来。说白了，它把 Git 这头“猛兽”套上了缰绳，让你用鼠标就能完成大部分日常操作。这篇 TortoiseGit 使用教程面向的是完全没碰过 Git 的新手，不要求你会命令行，也不要求你懂分支原理，只要你会用 Windows 右键菜单，就能跟着一步步把环境装好、把第一个项目克隆下来、把改动提交上去。如果你之前被命令行吓退过，或者一直用“复制文件夹加日期”的方式管理代码版本，那这套图文教程就是给你准备的。
2. 为什么值得学：Git 不是程序员的专属技能
2.1 先搞懂 Git 在管什么，再谈工具
你可以把 Git 想象成一个“带时间机器的文件夹”。平时我们改文件，改完就覆盖了，想找回昨天的版本只能靠记忆或者手动备份。Git 的做法是：每次你觉得“这一版可以了”，就让它拍一张快照存起来，以后随时能翻到任何一张快照。这个动作叫“提交”。而远程仓库（比如公司内网搭的 Git 服务、或者公开的代码托管平台）相当于一个云端保险柜，你把快照推上去，换台电脑也能拉下来，多人协作时大家往同一个保险柜里放东西、取东西。TortoiseGit 不改变 Git 的任何规则，它只是把“拍快照”“推保险柜”这些动作变成了右键菜单里的选项。所以你学 TortoiseGit 的同时，其实也在学 Git 的核心概念，只是不用先跟命令行搏斗。
2.2 图形化到底省掉了哪些麻烦
命令行里最容易翻车的地方是路径和参数。比如你想提交某个文件，得先cd到项目目录，再敲git add 文件名，文件名打错一个字符就白干。TortoiseGit 把这些都变成了勾选框：右键点“Git 提交”，弹窗里列出所有改动过的文件，你勾上要提交的，填一句说明，点确定就完事。再比如查看历史记录，命令行要敲git log --oneline --graph，图形界面里直接右键“显示日志”，谁在什么时候改了什么，一目了然。对于刚入门的人来说，少记一条命令就少一次放弃的理由。我第一次学的时候就是被git status输出的一堆英文劝退的，后来换成图形界面才慢慢把流程跑顺。
2.3 哪些人适合从 TortoiseGit 入门
如果你符合下面任意一条，这套教程就是为你写的：平时用 Windows 办公，习惯右键菜单操作；需要和团队一起维护文档、代码或设计稿，但不想花几天专门学命令行；之前用过 SVN 或 TFS 这类带图形界面的版本工具，想平移到 Git；或者你只是想把个人项目做个版本备份，免得改乱了找不回来。反过来说，如果你已经在命令行里用得挺顺，或者需要写自动化脚本批量操作仓库，那图形界面反而碍事，这部分内容可以跳过。入门阶段先用图形界面把“提交、拉取、推送”这套流程跑熟，等肌肉记忆有了，再去看命令行会发现那些参数也没那么可怕。
3. 动手之前：把环境和配置一次弄对
3.1 安装顺序不能乱：先 Git 后 TortoiseGit
TortoiseGit 本身不带 Git 内核，它只是一个外壳，所以必须先把 Git 装好。去 Git 的 Windows 版本发布页下载安装包，一路点“下一步”就行，安装路径记一下，后面配置要用。装完 Git 再装 TortoiseGit 主程序，最后装中文语言包。顺序反了的话，TortoiseGit 启动时找不到 Git 可执行文件，会弹窗让你手动指定路径，虽然也能补救，但新手容易在这里卡住。安装过程中有一个选项问你要不要用 TortoiseGit 处理 SSH 密钥，保持默认即可，后面生成密钥时它会接管。全部装完后在桌面空白处点右键，如果能看到“TortoiseGit”这一组菜单，说明外壳已经挂上了。
3.2 第一次打开设置：语言、路径、身份三件事
在任意文件夹空白处右键，选择 TortoiseGit → Settings。左边选 General，右边 Language 下拉里选“简体中文”，顺手把“检查更新”的勾去掉，免得每次弹升级提示。然后看 Git 那一栏，这里要填两样东西：一是 Git 可执行文件的路径，通常安装程序会自动识别，如果显示为空就手动指到 Git 安装目录下的bin文件夹；二是你的用户名和邮箱，这两个信息会写进每一次提交记录里，相当于你在版本历史里的签名。填完点“应用”再“确定”。这里有个细节：设置窗口分“全局”和“本地”两个层级，现在还没有打开任何项目，所以本地配置是灰的，等克隆了仓库之后，本地配置才会生效，用来给单个项目设置不同的身份。
3.3 让工具记住密码：凭证配置的取舍
用 HTTPS 地址克隆和推送时，每次都要输账号密码，烦得很。TortoiseGit 的设置里有一个“编辑全局 .git/config”按钮，点开后在文件末尾加两行：
[credential] helper = store保存关闭。这样下次推送时输入一次密码，它就会把凭证存到用户目录下的一个明文文件里，之后不再追问。方便是方便，但要注意这个文件是明文的，共用电脑的话别人能翻到。如果你介意，可以跳过这一步，每次手动输；或者改用 SSH 方式连接远程仓库，配好密钥后同样不用反复输密码，而且比明文存储稳妥。入门阶段先用 HTTPS 加记住密码把流程跑通，等熟悉了再切 SSH 也不迟。
提示：凭证文件的位置在用户主目录下，文件名以
.git-credentials结尾，不要把它提交到任何仓库里。
4. 第一个项目跑起来：克隆、提交、推送一条龙
4.1 克隆：把远程仓库搬到本地
假设远程仓库上已经有一个项目（空的仓库克隆下来会提示找不到分支，所以服务端至少要先有一个文件）。在你想存放项目的文件夹里右键，选 TortoiseGit → 克隆。弹窗里 URL 填远程仓库地址，目录填本地路径，点确定后会出现进度窗口。克隆成功后，文件夹图标上会多出一个小角标，这是 TortoiseGit 的状态标识：绿色对号表示和远程一致，红色感叹号表示有改动没提交，蓝色加号表示新增文件，蓝色问号表示还没纳入版本管理。如果角标没显示，通常是资源管理器刷新问题，按 F5 或者重启一下资源管理器就行。这一步做完，你本地就有了一个完整的项目副本，并且和远程仓库建立了关联。
4.2 提交：先把改动存到本地快照
随便改一个文件，比如在 README 里加一行字，或者新建一个hello.txt。然后在项目文件夹空白处右键，选 Git 提交 → “master”。弹窗上半部分是文件列表，勾选你要提交的文件；下半部分是说明框，写一句“新增 hello 文件”之类的话。点“提交”按钮，进度条走完就表示本地快照已经生成。注意提交只是存到本地，远程仓库还看不到你的改动。这里有个新手常犯的错：以为点了提交就万事大吉，结果同事拉不到你的代码。记住口诀——提交是存本地，推送才是发出去。
4.3 拉取再推送：多人协作的固定节奏
在推送之前，先做一次拉取。右键选 Git 同步，窗口里点“拉取”。如果远程没有新改动，会提示已经是最新；如果别人先推了东西，拉取会把他们的改动合并到你本地。这一步的意义是避免你基于旧版本推送，导致冲突。拉取完成后点“推送”，弹窗保持默认，确定，输入账号密码（如果配了记住密码就不用输），看到成功提示就完成了。整个循环可以记成：改文件 → 提交 → 拉取 → 推送。顺序别颠倒，先拉后推能挡掉大部分冲突。如果拉取时提示冲突，说明你和别人改了同一处，需要手动打开文件决定保留哪边，解决后再提交一次，然后重新推送。
# 图形界面背后对应的命令大致是这样，了解即可，不用手敲 git pull # 拉取远程更新并合并 git push # 把本地提交推到远程上面两行只是帮你理解“拉取”和“推送”在命令行里长什么样，日常操作在右键菜单里完成就行。参数方面，推送时默认推当前分支到同名远程分支，入门阶段不用改。
4.4 看懂状态角标，少问一半问题
文件图标上的小角标是 TortoiseGit 最实用的反馈机制。绿色对号：文件没动过，和仓库一致。红色感叹号：改过了但没提交。蓝色加号：新文件，还没被 Git 跟踪。蓝色问号：未受控，通常是没加入版本管理的文件。灰色减号：被忽略的文件。红色叉号：文件被删了。黄色感叹号：有冲突需要处理。刚上手时看到红色感叹号别慌，那只是提醒你“有东西没存快照”。养成习惯：每天收工前扫一眼角标，把该提交的提交掉，该推送的推送掉，第二天开工先拉取一次，基本不会出乱子。
5. 新手最容易踩的坑：排查清单
5.1 克隆下来是空文件夹，拉取还报错
现象：克隆完成后目录里什么都没有，点拉取提示找不到远程分支。原因：远程仓库是新建的，里面一个文件都没有，Git 没有可拉取的分支头。解决：让仓库管理员先在网页端或另一台机器上提交一个文件（比如 README），再重新克隆；或者本地先建一个文件提交推送上去，把分支撑起来。
5.2 提交按钮点了没反应，或者文件列表是空的
现象：右键提交，弹窗里一个文件都没有，或者勾选后点提交没动静。原因：多半是文件没有被 Git 跟踪，或者你改的文件在忽略规则里。解决：先看文件角标是不是蓝色问号，如果是，右键选“加入”把它纳入版本管理，再提交。另外检查项目根目录有没有.gitignore文件，里面列出的模式会被跳过，新手容易把自己新建的文件夹名写进忽略规则却忘了。
5.3 推送被拒绝，提示非快进
现象：推送时弹窗报错，大意是远程有你本地没有的提交。原因：别人在你拉取之后又推了新东西，你的本地历史落后了。解决：先拉取，把远程改动合并进来，解决可能的冲突，再重新推送。不要强行覆盖远程，那会把别人的提交冲掉。养成“推送前先拉取”的习惯能避免绝大多数这类问题。
5.4 每次推送都要输密码，配了记住密码也没用
现象：明明加了凭证配置，还是反复弹账号密码框。原因：配置加错了位置，加到了某个项目的本地配置里而不是全局配置；或者远程地址从 HTTPS 换成了 SSH，凭证助手对 SSH 不生效。解决：打开设置里的“编辑全局 .git/config”确认那两行在全局文件里；如果用的是 SSH 地址，需要配置密钥而不是凭证助手，两者是不同机制。
5.5 图标角标全没了，分不清文件状态
现象：文件夹里所有文件都是普通图标，没有绿色对号也没有红色感叹号。原因：Windows 资源管理器的图标覆盖数量有限，装的其他软件占用了名额；或者 TortoiseGit 的状态缓存没刷新。解决：先按 F5 刷新，不行就重启资源管理器；再不行在设置里把图标覆盖的优先级调高，或者减少同时安装的同类工具。角标只是辅助，实在修不好也不影响提交推送，右键菜单里的“检查修改”同样能看状态。
6. 跑通第一个项目之后，下一步学什么
第一个项目能克隆、能提交、能推送，说明你已经跨过了最难的启动门槛。接下来不建议一头扎进命令行的汪洋里，而是沿着你已经在用的图形界面往外扩一圈。先花半小时把“显示日志”点开，看看每次提交的记录长什么样，试着对比两个版本的差异，理解“快照”到底存了什么。然后练分支：在提交弹窗里勾选“新建分支”，起个名字，切过去改点东西再切回来，感受一下分支之间互不干扰是怎么回事。分支是 Git 真正好用的地方，但入门阶段不用深究合并策略，先建立“分支就是平行副本”的直觉就够了。
再往后可以碰一碰 SSH 密钥。在 TortoiseGit 的菜单里找到“版本库浏览器”或者用开始菜单里的 Puttygen 生成一对密钥，把公钥贴到远程仓库的账户设置里，然后把克隆地址从 HTTPS 换成 SSH 再克隆一次。这一步做完，你就同时掌握了两种连接方式，以后遇到哪种环境都能应付。如果团队里有人用命令行，可以让他们演示一遍git status和git log，你会发现图形界面里点过的每个按钮，背后都对应一条命令，这时候再回头看命令行，抵触感会小很多。
学习节奏上，我的血泪经验是：不要等“学完所有功能”再动手，而是每学一个操作就找一个真实的小项目去用。哪怕只是个人写的一个文本文件合集，也值得建个仓库管起来。用着用着你会发现，真正高频的只有提交、拉取、推送、看日志这四件事，其他功能遇到再查。从那以后我每次新建项目，都强制自己先克隆再动手，绝不直接在远程网页上改文件，这个习惯帮我省掉了无数次“本地和远程对不上”的麻烦。希望帮到你。
本文还有配套的精品资源，点击获取
