好的，阿杰 😊
下面给你整理一份 TortoiseGit 使用教程（超详细入门版），涵盖安装、配置、基本操作、常见问题，适合新手快速上手。

🐢 TortoiseGit 使用教程【超详细】

一、TortoiseGit 简介

  • TortoiseGit 是 Windows 下的 Git 图形化客户端，集成在右键菜单中，适合不熟悉命令行的人使用。
  • 它依赖 Git for Windows，所以必须先安装 Git。

二、环境准备

1. 安装 Git

  1. 下载 Git for Windows 👉 https://git-scm.com/download/win
  2. 一路“Next”，保持默认即可。
  3. 安装完成后，在终端输入：git --version 显示版本号说明安装成功。

2. 安装 TortoiseGit

  1. 下载 👉 https://tortoisegit.org/download/
    （根据系统 64-bit / 32-bit 选择）
  2. 安装时可以勾选 语言包（中文）。
  3. 安装完成后，右键菜单里会看到 TortoiseGit。

三、第一次配置

1. 配置用户名与邮箱

右键 → TortoiseGit → 设置 → Git → 编辑全局设置，填入：

  • 用户名（与 GitHub / Gitee 一致）
  • 邮箱

等价于命令：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

2. 生成并配置 SSH Key

  1. 打开 TortoiseGit → 设置 → 网络 → PuTTY/SSH → 生成密钥
  2. 点击 生成密钥 (Generate Key) → 保存 .ppk 私钥
  3. 打开 GitHub/Gitee → 个人设置 → SSH Keys → 粘贴公钥
  4. 测试是否成功：ssh -T git@github.com

四、常用操作

1. 克隆项目（Clone）

  1. 在空白文件夹右键 → Git Clone
  2. 填写仓库地址（GitHub/Gitee 提供的 SSH/HTTPS 链接）
  3. 选择目录，点击 OK → 项目下载完成。

2. 拉取更新（Pull）

  1. 在项目文件夹右键 → Git Pull
  2. 选择远程分支（一般默认 origin/main 或 origin/master）
  3. 点击 OK → 拉取完成。

3. 提交代码（Commit）

  1. 修改代码后，右键项目文件夹 → Git Commit → master
  2. 选择要提交的文件，填写 提交信息
  3. 点击 提交 (Commit)

⚠️ 注意：Commit 只是提交到本地仓库，还没推送到远程。

4. 推送代码（Push）

  1. 右键项目 → TortoiseGit → Push
  2. 选择远程分支（一般 origin/main）
  3. 点击 OK → 推送成功。

5. 分支管理（Branch）

  • 新建分支：右键 → TortoiseGit → Create Branch
  • 切换分支：右键 → TortoiseGit → Switch/Checkout
  • 合并分支：右键 → TortoiseGit → Merge

五、常见问题与解决

1. SSH 无法连接

  • 确认 SSH Key 已配置在 GitHub/Gitee
  • 确认 TortoiseGit → 设置 → 网络 → PuTTY/SSH 客户端 已设置正确路径
  • 用 ssh -T git@github.com 测试。

2. 提交乱码

  • 设置编码：TortoiseGit → 设置 → Git → 常规 → 选择 UTF-8。

3. 拒绝 fast-forward

  • 需要先拉取更新，再推送：git pull --rebase git push

4. 提交冲突

  • 冲突文件会标红
  • 右键 → 解决冲突 (Resolve Conflicts)
  • 手动修改文件 → 标记已解决 → 再次提交。

六、TortoiseGit 使用小技巧

  • 显示日志：右键 → Show log 可以查看提交历史
  • Revert：撤销修改
  • Stash：暂存修改，方便切换分支
  • Blame：查看每行代码是谁提交的

⚡ 总结：

  • Clone → 修改 → Commit → Push 是最基本流程
  • 熟悉分支管理后，可以进行团队协作开发
  • 记住：Commit 本地，Push 远程