简介这份资源是面向 Windows 平台 Git 初学者的 TortoiseGit 图文使用教程以 docx 文档形式系统梳理了从环境搭建到日常版本控制的完整流程帮助不熟悉命令行的用户借助右键菜单快速上手 Git。压缩包内共 1 个 docx 文件约 1.15MB内容涵盖 Git 与 TortoiseGit 及中文语言包的下载安装、General 与 Git 选项卡配置、用户名邮箱设置、凭证助手与 SSH Key 的生成和上传以及克隆、拉取、合并、提交、推送和分支管理等常用操作并配有文件状态角标含义说明与 HTTPS、SSH 两种连接方式的对比。目前已有 2152 人学习适合需要按图索骥完成配置、减少反复输入账号密码困扰的入门读者对照实践也可作为团队内部培训的参考材料。1. TortoiseGit 使用教程Windows 上把 Git 操作压进右键菜单的那套方案如果你在 Windows 上带过新人大概率见过这个场面命令行里git status敲得飞起旁边的人盯着黑框一脸茫然最后所有操作都变成“你帮我提交一下”。TortoiseGit 就是冲着这个场景来的——它把 Git 的克隆、提交、拉取、推送、分支管理全部塞进资源管理器的右键菜单配合状态角标文件改没改、有没有冲突扫一眼文件夹就知道。这份教程覆盖的是从零到能干活的全链路装 Git、装小海龟和中文语言包、配用户名邮箱、配凭证助手或 SSH Key、克隆、提交、同步拉取、推送以及那套角标符号到底代表什么。适合刚接触版本控制的 Windows 开发者、从 SVN/TFS 迁过来的老手以及需要给团队统一操作入口的技术负责人。下面按我实际拆这套流程的顺序讲参数和坑都落到具体位置。2. 环境搭建与全局配置Git、语言包、git.exe 路径三件事2.1 安装顺序与 git.exe 路径的绑定逻辑TortoiseGit 本身不含 Git 内核它只是一层壳所有实际操作最终都调用git.exe。所以安装顺序必须是先 Git for Windows再 TortoiseGit最后中文语言包。顺序反了不是不能救但配置界面里会多一步手动指定路径新手容易在这里卡住。Git 安装过程一路默认即可唯一值得留意的是安装路径别带中文和空格常见做法是D:\Program Files\Git。装完 TortoiseGit 后第一次打开设置如果它没自动探测到 Git就要在 General 页手动填git.exe所在目录注意填的是bin目录而不是cmd目录# 验证 Git 是否已正确安装并进入 PATH git --version # 输出形如 git version 2.x.x.windows.1 即正常 # 查看 git.exe 实际位置配置 TortoiseGit 时填这个目录 where git # 典型输出D:\Program Files\Git\cmd\git.exe这里有个容易翻车的点where git返回的往往是cmd\git.exe但 TortoiseGit 设置里要的是bin目录。两个目录下都有 git.exe功能上bin版本更完整填cmd有时会导致某些子命令调用异常。我一般直接填D:\Program Files\Git\bin一次到位。语言包必须在 TortoiseGit 主程序装完之后再装装早了会被覆盖。装完进 Settings → General右侧 Language 下拉选“简体中文”同时把“检查更新”那个勾去掉——内网环境或离线机器上升级检查会在每次右键时卡一下体验很差。2.2 用户名、邮箱与凭证助手的配置边界Git 的每次提交都带作者信息这个信息来自配置不是来自 Windows 登录账号。所以配用户名和邮箱是必做项进 Settings → Git 页右边填 Name 和 Email。这里填的邮箱最好和远程仓库账号一致否则提交记录里的作者和平台账号对不上代码评审时追溯会很难受。同一页上有两个按钮要分清“编辑全局 .git/config”改的是当前用户所有仓库的默认配置“编辑本地 .git/config”只在某个已存在的仓库目录下打开设置时才可用只对该项目生效。教程里提到的“本地”其实是“局部”翻译有点误导理解成项目级覆盖就行。凭证这块HTTPS 方式下每次推送都要输账号密码解决办法是在全局配置文件末尾加两行[credential] helper store保存后下次用 HTTPS URL 推送时输入一次账号密码之后会被记住。代价是密码以明文形式落在C:\Users\用户名\.git-credentials里任何能读这个文件的程序都能拿到。共享机器、公司公用电脑上不要开这个宁可每次手输。想要一劳永逸且相对安全走 SSH 方式下面单独讲。提示helper store记住的是远程仓库的登录账号密码不是你提交时用的 Name/Email两者别混。3. SSH Key 从生成到克隆绕开 HTTPS 反复输密码的路3.1 用 Git GUI 生成密钥对并识别文件角色SSH 方式的前提是本地有一对密钥公钥交给服务器私钥留在本地。先看用户主目录下有没有.ssh文件夹里面有没有id_rsa和id_rsa.pub。有就直接用没有就生成。生成方式不止命令行一种TortoiseGit 自带的 Git GUI 更直观任意文件夹右键 → Git GUI Here → 菜单 Help → Show SSH Key没有 Key 就点 Generate Key生成后把整段内容复制出来。生成完成后用户主目录下会出现.ssh目录两个文件的角色必须记牢文件角色能否外传id_rsa私钥绝对不能泄露等于别人能冒充你推送id_rsa.pub公钥可以就是要贴到服务器上的那段命令行方式等价适合脚本化或远程操作# 生成一对 RSA 密钥-C 后面跟注释一般填邮箱便于识别 ssh-keygen -t rsa -b 4096 -C your_emailexample.com # 一路回车用默认路径 ~/.ssh/id_rsa密码短语可留空 # 打印公钥内容复制整段贴到服务器 cat ~/.ssh/id_rsa.pub-b 4096指密钥长度比默认 2048 更稳生成稍慢但一次性的事。密码短语留空是为了免交互如果机器多人共用建议设一个代价是每次用 Key 要输一次。3.2 公钥落到服务器与 SSH URL 克隆的完整动作公钥要贴到 Git 服务端的账号设置里。不同平台入口名字不同但路径逻辑一致登录后进账号设置找 SSH Keys 相关页面新建把id_rsa.pub全文粘进去保存。服务端只存公钥靠它验证“持有对应私钥的人”就是你所以私钥永远不出本地。贴完之后验证连通性再克隆# 测试与服务器的 SSH 认证是否打通 ssh -T gityour-git-server.com # 首次连接会提示确认主机指纹输入 yes # 成功时返回类似 Hi username! Youve successfully authenticated # 用 SSH URL 克隆注意地址是 git 开头而非 https:// git clone gityour-git-server.com:group/project.git图形界面下等价操作是本地目标文件夹空白处右键 → Git 克隆URL 填 SSH 地址选好本地目录确定。进度窗口跑完文件夹上出现绿色对号角标就成功了。有个报错值得单独记fatal: Couldnt find remote ref HEAD。这通常不是 SSH 配错了而是远程仓库是个空库一个提交都没有克隆时找不到 HEAD 引用。解决办法是先在服务端建一个初始文件比如 README提交上去再克隆。教程里专门提了这句是血泪经验别忽略。4. 日常提交与同步角标、提交、拉取、推送的实操顺序4.1 七种状态角标的含义与不显示的排查TortoiseGit 最实用的设计是文件角标扫一眼就知道仓库状态。七种符号对应七种状态绿色对号是正常未改动红色感叹号是已修改蓝色加号是新添加待提交蓝色问号是未受控不在版本控制里灰色减号是被忽略红色叉号是已删除黄色感叹号是有冲突。这套符号是日常判断“我现在该干什么”的第一手信息。角标不显示是高频问题现象是文件夹干干净净什么标记都没有。原因通常是资源管理器图标覆盖槽位被占满或者 TortoiseGit 的图标覆盖组件没随系统启动。解决顺序先重启资源管理器不行就进 Settings 检查 Icon Overlays 是否启用、状态缓存是否要清再不行看是不是装了多个同类工具抢槽位。Windows 的图标覆盖槽位有限装多了必然有工具抢不到。4.2 提交到本地、先拉后推的协作节奏标准流程是四步改文件 → 提交到本地 → 拉取远程 → 推送。很多人省掉第三步直接推单人项目没事多人协作时冲突就来了。提交项目空白处右键 → Git 提交 → “master”弹窗里填提交说明勾选要提交的文件点提交。这一步只写进本地仓库远程还看不到。提交成功后提示窗口上有“推送”按钮但先别急。拉取右键 → Git 同步打开同步窗口点“拉取”。如果远程没变化提示已是最新如果远程被别人改过而你本地也改了同一处就会报冲突需要先解决冲突再提交结果。这就是为什么改代码前先拉一下能省大量麻烦。推送同步窗口点“推送”或右键菜单 TortoiseGit → 推送弹窗一般保持默认确定输入账号密码配了凭证助手就自动带出进度跑完显示成功。# 图形界面背后等价的一组命令理解流程用 git add Hello.txt # 把新文件纳入暂存 git commit -m add Hello.txt # 提交到本地仓库 git pull # 先拉远程减少冲突 git push # 再推送到远程参数上没什么可调的关键是顺序。git pull在图形界面里对应“拉取”它等于 fetch 加 merge冲突就在 merge 阶段暴露。如果团队约定用 rebase 保持线性历史同步窗口里可以勾选变基选项但新手阶段不建议开冲突处理会更绕。注意提交说明别写“修改”“更新”这种词三个月后回看提交历史你会感谢当时写清楚“修复登录超时判断”的自己。5. 避坑与排查五个真实翻车现场现象一右键菜单里找不到 TortoiseGit 选项。原因多半是安装时没勾选“在资源管理器中集成”或者装完没重启资源管理器。解决重装时确认集成选项或任务管理器里重启 Windows 资源管理器进程64 位系统上还要确认装的是 64 位版本32 位壳程序在 64 位资源管理器里不显示菜单。现象二克隆时提示Couldnt find remote ref HEAD。原因不是网络也不是权限是远程仓库为空没有任何提交。解决先在服务端网页上初始化一个 README 并提交再执行克隆。现象三推送一直要求输密码配了凭证助手也没用。原因通常是仓库用的是 SSH URL而凭证助手只管 HTTPS或者全局配置改在了项目级.git/config里但当前操作的是另一个仓库。解决确认远程 URL 协议git remote -v看一眼HTTPS 才走 helperSSH 走 Key两条路别混。现象四角标全是问号已提交的文件也显示未受控。原因是仓库根目录识别错了比如在子目录里初始化或者.git目录被移动过。解决确认操作目录下有.git文件夹在仓库根目录右键看状态必要时重新克隆一份别在错位的目录里硬修。现象五拉取报冲突后不知道怎么收场。原因是本地和远程改了同一文件的同一区域Git 不敢替你决定。解决打开冲突文件会看到、、标记手动保留正确内容、删掉标记然后右键 → 解决冲突 → 标记为已解决再提交、再推送。别直接删文件重来那样会丢别人的改动。6. 进阶技巧用日志视图和分支操作把协作风险压下去图形界面真正的价值不在提交那几下而在“看得见历史”。同步窗口里的日志页、右键菜单的“显示日志”能把提交历史、分支走向、每次改动涉及哪些文件摊开给你看。我排查“这行代码谁改的、为什么改”时第一动作不是命令行git log而是打开日志视图按文件过滤比翻终端快得多。分支操作也是同理。右键 → TortoiseGit → 创建分支填名字确定切换分支在同一个菜单里。团队里常见的做法是主干只放稳定代码功能开发开独立分支做完再合并。合并前先拉取目标分支到本地在日志视图里确认差异范围再执行合并冲突概率会低很多。合并冲突的处理和上一章的拉取冲突一样标记解决后提交即可。一个具体技巧提交前用“检查修改”看差异。右键 → 检查修改能看到每个改动文件的具体行级 diff红色删除绿色新增。养成提交前扫一眼的习惯能拦住误提交调试代码、误删配置这类低级错误。我见过太多人提交说明写得漂亮diff 里却夹着本地数据库密码。还有一点关于凭证的收尾如果之前开了helper store后来想关掉把全局配置里那两行删掉再删C:\Users\用户名\.git-credentials文件即可否则旧密码还留在那。从那以后我每次给新机器配环境都会先确认远程 URL 是 HTTPS 还是 SSH再决定配凭证助手还是贴公钥两步走错一步后面就是反复输密码的循环。希望帮到你。本文还有配套的精品资源点击获取
简介这份资源是面向 Windows 平台 Git 初学者的 TortoiseGit 图文使用教程以 docx 文档形式系统梳理了从环境搭建到日常版本控制的完整流程帮助不熟悉命令行的用户借助右键菜单快速上手 Git。压缩包内共 1 个 docx 文件约 1.15MB内容涵盖 Git 与 TortoiseGit 及中文语言包的下载安装、General 与 Git 选项卡配置、用户名邮箱设置、凭证助手与 SSH Key 的生成和上传以及克隆、拉取、合并、提交、推送和分支管理等常用操作并配有文件状态角标含义说明与 HTTPS、SSH 两种连接方式的对比。目前已有 2152 人学习适合需要按图索骥完成配置、减少反复输入账号密码困扰的入门读者对照实践也可作为团队内部培训的参考材料。1. TortoiseGit 使用教程Windows 上把 Git 操作压进右键菜单的那套方案如果你在 Windows 上带过新人大概率见过这个场面命令行里git status敲得飞起旁边的人盯着黑框一脸茫然最后所有操作都变成“你帮我提交一下”。TortoiseGit 就是冲着这个场景来的——它把 Git 的克隆、提交、拉取、推送、分支管理全部塞进资源管理器的右键菜单配合状态角标文件改没改、有没有冲突扫一眼文件夹就知道。这份教程覆盖的是从零到能干活的全链路装 Git、装小海龟和中文语言包、配用户名邮箱、配凭证助手或 SSH Key、克隆、提交、同步拉取、推送以及那套角标符号到底代表什么。适合刚接触版本控制的 Windows 开发者、从 SVN/TFS 迁过来的老手以及需要给团队统一操作入口的技术负责人。下面按我实际拆这套流程的顺序讲参数和坑都落到具体位置。2. 环境搭建与全局配置Git、语言包、git.exe 路径三件事2.1 安装顺序与 git.exe 路径的绑定逻辑TortoiseGit 本身不含 Git 内核它只是一层壳所有实际操作最终都调用git.exe。所以安装顺序必须是先 Git for Windows再 TortoiseGit最后中文语言包。顺序反了不是不能救但配置界面里会多一步手动指定路径新手容易在这里卡住。Git 安装过程一路默认即可唯一值得留意的是安装路径别带中文和空格常见做法是D:\Program Files\Git。装完 TortoiseGit 后第一次打开设置如果它没自动探测到 Git就要在 General 页手动填git.exe所在目录注意填的是bin目录而不是cmd目录# 验证 Git 是否已正确安装并进入 PATH git --version # 输出形如 git version 2.x.x.windows.1 即正常 # 查看 git.exe 实际位置配置 TortoiseGit 时填这个目录 where git # 典型输出D:\Program Files\Git\cmd\git.exe这里有个容易翻车的点where git返回的往往是cmd\git.exe但 TortoiseGit 设置里要的是bin目录。两个目录下都有 git.exe功能上bin版本更完整填cmd有时会导致某些子命令调用异常。我一般直接填D:\Program Files\Git\bin一次到位。语言包必须在 TortoiseGit 主程序装完之后再装装早了会被覆盖。装完进 Settings → General右侧 Language 下拉选“简体中文”同时把“检查更新”那个勾去掉——内网环境或离线机器上升级检查会在每次右键时卡一下体验很差。2.2 用户名、邮箱与凭证助手的配置边界Git 的每次提交都带作者信息这个信息来自配置不是来自 Windows 登录账号。所以配用户名和邮箱是必做项进 Settings → Git 页右边填 Name 和 Email。这里填的邮箱最好和远程仓库账号一致否则提交记录里的作者和平台账号对不上代码评审时追溯会很难受。同一页上有两个按钮要分清“编辑全局 .git/config”改的是当前用户所有仓库的默认配置“编辑本地 .git/config”只在某个已存在的仓库目录下打开设置时才可用只对该项目生效。教程里提到的“本地”其实是“局部”翻译有点误导理解成项目级覆盖就行。凭证这块HTTPS 方式下每次推送都要输账号密码解决办法是在全局配置文件末尾加两行[credential] helper store保存后下次用 HTTPS URL 推送时输入一次账号密码之后会被记住。代价是密码以明文形式落在C:\Users\用户名\.git-credentials里任何能读这个文件的程序都能拿到。共享机器、公司公用电脑上不要开这个宁可每次手输。想要一劳永逸且相对安全走 SSH 方式下面单独讲。提示helper store记住的是远程仓库的登录账号密码不是你提交时用的 Name/Email两者别混。3. SSH Key 从生成到克隆绕开 HTTPS 反复输密码的路3.1 用 Git GUI 生成密钥对并识别文件角色SSH 方式的前提是本地有一对密钥公钥交给服务器私钥留在本地。先看用户主目录下有没有.ssh文件夹里面有没有id_rsa和id_rsa.pub。有就直接用没有就生成。生成方式不止命令行一种TortoiseGit 自带的 Git GUI 更直观任意文件夹右键 → Git GUI Here → 菜单 Help → Show SSH Key没有 Key 就点 Generate Key生成后把整段内容复制出来。生成完成后用户主目录下会出现.ssh目录两个文件的角色必须记牢文件角色能否外传id_rsa私钥绝对不能泄露等于别人能冒充你推送id_rsa.pub公钥可以就是要贴到服务器上的那段命令行方式等价适合脚本化或远程操作# 生成一对 RSA 密钥-C 后面跟注释一般填邮箱便于识别 ssh-keygen -t rsa -b 4096 -C your_emailexample.com # 一路回车用默认路径 ~/.ssh/id_rsa密码短语可留空 # 打印公钥内容复制整段贴到服务器 cat ~/.ssh/id_rsa.pub-b 4096指密钥长度比默认 2048 更稳生成稍慢但一次性的事。密码短语留空是为了免交互如果机器多人共用建议设一个代价是每次用 Key 要输一次。3.2 公钥落到服务器与 SSH URL 克隆的完整动作公钥要贴到 Git 服务端的账号设置里。不同平台入口名字不同但路径逻辑一致登录后进账号设置找 SSH Keys 相关页面新建把id_rsa.pub全文粘进去保存。服务端只存公钥靠它验证“持有对应私钥的人”就是你所以私钥永远不出本地。贴完之后验证连通性再克隆# 测试与服务器的 SSH 认证是否打通 ssh -T gityour-git-server.com # 首次连接会提示确认主机指纹输入 yes # 成功时返回类似 Hi username! Youve successfully authenticated # 用 SSH URL 克隆注意地址是 git 开头而非 https:// git clone gityour-git-server.com:group/project.git图形界面下等价操作是本地目标文件夹空白处右键 → Git 克隆URL 填 SSH 地址选好本地目录确定。进度窗口跑完文件夹上出现绿色对号角标就成功了。有个报错值得单独记fatal: Couldnt find remote ref HEAD。这通常不是 SSH 配错了而是远程仓库是个空库一个提交都没有克隆时找不到 HEAD 引用。解决办法是先在服务端建一个初始文件比如 README提交上去再克隆。教程里专门提了这句是血泪经验别忽略。4. 日常提交与同步角标、提交、拉取、推送的实操顺序4.1 七种状态角标的含义与不显示的排查TortoiseGit 最实用的设计是文件角标扫一眼就知道仓库状态。七种符号对应七种状态绿色对号是正常未改动红色感叹号是已修改蓝色加号是新添加待提交蓝色问号是未受控不在版本控制里灰色减号是被忽略红色叉号是已删除黄色感叹号是有冲突。这套符号是日常判断“我现在该干什么”的第一手信息。角标不显示是高频问题现象是文件夹干干净净什么标记都没有。原因通常是资源管理器图标覆盖槽位被占满或者 TortoiseGit 的图标覆盖组件没随系统启动。解决顺序先重启资源管理器不行就进 Settings 检查 Icon Overlays 是否启用、状态缓存是否要清再不行看是不是装了多个同类工具抢槽位。Windows 的图标覆盖槽位有限装多了必然有工具抢不到。4.2 提交到本地、先拉后推的协作节奏标准流程是四步改文件 → 提交到本地 → 拉取远程 → 推送。很多人省掉第三步直接推单人项目没事多人协作时冲突就来了。提交项目空白处右键 → Git 提交 → “master”弹窗里填提交说明勾选要提交的文件点提交。这一步只写进本地仓库远程还看不到。提交成功后提示窗口上有“推送”按钮但先别急。拉取右键 → Git 同步打开同步窗口点“拉取”。如果远程没变化提示已是最新如果远程被别人改过而你本地也改了同一处就会报冲突需要先解决冲突再提交结果。这就是为什么改代码前先拉一下能省大量麻烦。推送同步窗口点“推送”或右键菜单 TortoiseGit → 推送弹窗一般保持默认确定输入账号密码配了凭证助手就自动带出进度跑完显示成功。# 图形界面背后等价的一组命令理解流程用 git add Hello.txt # 把新文件纳入暂存 git commit -m add Hello.txt # 提交到本地仓库 git pull # 先拉远程减少冲突 git push # 再推送到远程参数上没什么可调的关键是顺序。git pull在图形界面里对应“拉取”它等于 fetch 加 merge冲突就在 merge 阶段暴露。如果团队约定用 rebase 保持线性历史同步窗口里可以勾选变基选项但新手阶段不建议开冲突处理会更绕。注意提交说明别写“修改”“更新”这种词三个月后回看提交历史你会感谢当时写清楚“修复登录超时判断”的自己。5. 避坑与排查五个真实翻车现场现象一右键菜单里找不到 TortoiseGit 选项。原因多半是安装时没勾选“在资源管理器中集成”或者装完没重启资源管理器。解决重装时确认集成选项或任务管理器里重启 Windows 资源管理器进程64 位系统上还要确认装的是 64 位版本32 位壳程序在 64 位资源管理器里不显示菜单。现象二克隆时提示Couldnt find remote ref HEAD。原因不是网络也不是权限是远程仓库为空没有任何提交。解决先在服务端网页上初始化一个 README 并提交再执行克隆。现象三推送一直要求输密码配了凭证助手也没用。原因通常是仓库用的是 SSH URL而凭证助手只管 HTTPS或者全局配置改在了项目级.git/config里但当前操作的是另一个仓库。解决确认远程 URL 协议git remote -v看一眼HTTPS 才走 helperSSH 走 Key两条路别混。现象四角标全是问号已提交的文件也显示未受控。原因是仓库根目录识别错了比如在子目录里初始化或者.git目录被移动过。解决确认操作目录下有.git文件夹在仓库根目录右键看状态必要时重新克隆一份别在错位的目录里硬修。现象五拉取报冲突后不知道怎么收场。原因是本地和远程改了同一文件的同一区域Git 不敢替你决定。解决打开冲突文件会看到、、标记手动保留正确内容、删掉标记然后右键 → 解决冲突 → 标记为已解决再提交、再推送。别直接删文件重来那样会丢别人的改动。6. 进阶技巧用日志视图和分支操作把协作风险压下去图形界面真正的价值不在提交那几下而在“看得见历史”。同步窗口里的日志页、右键菜单的“显示日志”能把提交历史、分支走向、每次改动涉及哪些文件摊开给你看。我排查“这行代码谁改的、为什么改”时第一动作不是命令行git log而是打开日志视图按文件过滤比翻终端快得多。分支操作也是同理。右键 → TortoiseGit → 创建分支填名字确定切换分支在同一个菜单里。团队里常见的做法是主干只放稳定代码功能开发开独立分支做完再合并。合并前先拉取目标分支到本地在日志视图里确认差异范围再执行合并冲突概率会低很多。合并冲突的处理和上一章的拉取冲突一样标记解决后提交即可。一个具体技巧提交前用“检查修改”看差异。右键 → 检查修改能看到每个改动文件的具体行级 diff红色删除绿色新增。养成提交前扫一眼的习惯能拦住误提交调试代码、误删配置这类低级错误。我见过太多人提交说明写得漂亮diff 里却夹着本地数据库密码。还有一点关于凭证的收尾如果之前开了helper store后来想关掉把全局配置里那两行删掉再删C:\Users\用户名\.git-credentials文件即可否则旧密码还留在那。从那以后我每次给新机器配环境都会先确认远程 URL 是 HTTPS 还是 SSH再决定配凭证助手还是贴公钥两步走错一步后面就是反复输密码的循环。希望帮到你。本文还有配套的精品资源点击获取
