跳转至

TortoiseGit 使用教程

本教程是可选内容。当前主流程是 Git 命令行拉取教程：用 git clone 下载仓库，用 git pull 同步仓库，再通过 Gitea 网页提交个人文件。

如果你不想使用命令行，或者组长要求你用图形化工具，可以参考本教程。

目标不是学习完整 Git，而是会完成本项目需要的几件事：

  • 第一次下载仓库。
  • 每天开始前 Pull。
  • 必要时本地 Commit 和 Push。
  • 网页提交后同步本地仓库。
  • 出错时知道哪些按钮不能乱点。

1. 安装准备

可选安装顺序：

  1. 安装 Git for Windows。
  2. 安装 TortoiseGit。
  3. 如需中文界面，再安装 TortoiseGit 简体中文语言包。

官方下载入口：

  • Git for Windows：https://git-scm.com/downloads/win
  • TortoiseGit：https://tortoisegit.org/download/

一般 Windows 电脑选择 64-bit 安装包。如果不确定电脑类型，优先问组长，不要随便下载 ARM64 版本。

安装时大多数选项保持默认即可。安装完成后，建议重启一次电脑或重启资源管理器，这样右键菜单更容易正常出现。

2. 第一次下载仓库

  1. 新建一个本地文件夹，例如：
D:\实训项目\
  1. 在文件夹空白处右键。
  2. 选择 Git Clone...。
  3. 在 URL 中填写小组仓库地址 http://172.20.2.57:3000/admin/lz_group_6。
  4. Directory 保持默认或选择你想保存的位置。
  5. 点击 OK。
  6. 如果要求登录，使用自己的 Gitea 账号。

下载成功后，你会得到一个小组仓库文件夹。

3. 每天开始前 Pull

每天开始写文件前，必须先同步线上仓库：

  1. 右键小组仓库文件夹。
  2. 选择 TortoiseGit -> Pull...。
  3. 点击 OK。
  4. 看到成功提示后再开始修改文件。

不要跳过 Pull。跳过 Pull 容易导致你基于旧文件继续修改。

4. 网页提交后也要 Pull

如果你是在 Gitea 网页上提交了文件，线上仓库已经变了，但你电脑里的本地仓库还没变。

网页提交后要做：

  1. 回到本地小组仓库文件夹。
  2. 右键选择 TortoiseGit -> Pull...。
  3. 成功后再继续编辑本地文件。

5. 本地 Commit 和 Push

如果你是在本地修改文件，可以用 TortoiseGit 提交。

  1. 右键小组仓库文件夹。
  2. 选择 Git Commit -> 当前分支。
  3. 只勾选自己本次修改的文件。
  4. 在提交说明中写清楚姓名和成果。
  5. 点击 Commit。
  6. Commit 成功后，再右键选择 TortoiseGit -> Push...。
  7. 点击 OK。

注意：Commit 只是保存到自己电脑；Push 后 Gitea 网页才看得到。

提交说明格式：

docs: 姓名 提交成果名v1

示例：

docs: 张三 提交清洗过程说明v1
docs: 李四 更新指标字典v2
fix: 王五 修正外链登记

6. 本项目只改自己的文件

可以改：

  • 自己的过程记录。
  • 自己的外链登记。
  • 自己负责的清洗说明、指标说明、看板说明。
  • 自己的实训报告和简历。

不要直接改：

  • 总报告。
  • 总 PPT。
  • 总 README。
  • 外链登记总表。
  • 操作手册终版。

公共文件默认由组长整合。确实需要改公共文件时，先在群里说明。

7. 常见按钮含义

操作 可以什么时候用
Clone 第一次下载仓库
Pull 每天开始前、网页提交后
Commit 本地修改后保存一次提交
Push Commit 后上传到 Gitea
Show log 查看提交历史

8. 不要乱点的操作

看到以下按钮或提示时，不要自己处理：

  • Force Push
  • Reset
  • Revert
  • Resolve using mine
  • Resolve using theirs
  • Delete
  • Clean up
  • conflict
  • overwrite

正确做法：

  1. 截图。
  2. 发到团队群。
  3. 说明自己刚才做了什么。
  4. 等组长确认后再继续。

9. 每次提交前自查

  • 我是否先 Pull 了？
  • 我是否只改了自己负责的文件？
  • 文件名是否符合规范？
  • 有没有把大文件放进仓库？
  • 外链是否写进自己的外链登记？
  • 提交说明是否带姓名和成果？
  • 如果本地 Commit 了，是否已经 Push？
  • 如果网页提交了，本地是否已经 Pull？

更多检查项见 提交检查清单。