跳转至

Git 提交流程

目标：每位成员都用自己的账号提交自己负责的成果，让仓库历史能看出每个人做了什么。

本项目优先使用低门槛流程。详细原因见 Gitea 简化协作建议。

如果你只需要下载和同步仓库，先看 Git 命令行拉取教程。

1. 第一次准备

需要准备：

  • 内网 Gitea 账号。
  • 小组成果仓库地址：http://172.20.2.57:3000/admin/lz_group_6。
  • 自己负责的文件或目录。
  • Git for Windows。

不要使用组长或其他成员的账号提交。

2. 第一次下载仓库

打开 PowerShell，进入你想保存项目的位置，例如：

cd D:\实训项目

执行：

git clone http://172.20.2.57:3000/admin/lz_group_6

如果要求登录，使用自己的 Gitea 账号。

3. 每天开始前 Pull

每天开始工作前，进入仓库目录：

cd D:\实训项目\lz_group_6

执行：

git pull

看到成功后再开始改文件。

不要跳过这一步。跳过 Pull 容易让你的本地文件落后于线上仓库。

4. 只改自己负责的文件

推荐做法：

  • 自己的个人过程记录由自己改。
  • 自己的个人实训报告由自己改。
  • 自己的外链登记文件由自己改。
  • 数据质量检查、指标字典、看板说明等按分工负责人修改。

公共文件默认由组长整合：

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

如果你确实需要修改公共文件，先在群里说明修改范围，等组长确认。

5. 推荐提交方式：Gitea 网页提交

适合提交：

  • Markdown 文档。
  • 外链登记。
  • 小型说明文件。
  • 看板截图说明。
  • 个人过程记录。

网页提交流程：

  1. 打开 Gitea 仓库网页。
  2. 确认右上角是自己的账号。
  3. 进入自己负责的文件路径。
  4. 上传或编辑文件。
  5. 填写提交说明。
  6. 提交到主分支。
  7. 在群里发提交说明或截图。
  8. 回到本地仓库，执行一次 Pull。

网页提交后本地也要执行 git pull，否则你电脑上的文件会落后。

6. 命令行本地提交

当前普通队员主要通过 Gitea 网页提交个人文件。

如果你是组长，或确实需要一次性提交多个文件夹，可以使用命令行提交。

进入仓库目录：

cd E:\实训\仓库\lz_group_6

先同步：

git pull

查看当前改动：

git status

6.1 提交全部改动

适合一次性提交目录初始化、模板文件、批量文档整理。

git add .
git commit -m "docs: 组长 初始化项目目录和协作模板"
git push

6.2 只提交某个文件夹

示例：只提交 文档/。

git add 文档/
git commit -m "docs: 组长 初始化文档目录和模板"
git push

示例：只提交外链登记目录。

git add 其他/外链登记/
git commit -m "docs: 组长 初始化外链登记目录"
git push

6.3 只提交某几个文件

git add README.md
git add 文档/需求文档/README.md
git add 文档/需求文档/LZ-组6_需求文档模板.md
git commit -m "docs: 组长 初始化需求文档模板"
git push

路径里如果有空格，用英文双引号包起来：

git add "文档/某 个 文件.md"

6.4 查看将要提交什么

查看工作区状态：

git status

查看已经 git add、准备进入本次提交的文件名：

git diff --cached --name-only

查看已暂存的具体内容变化：

git diff --cached

6.5 add 错了怎么办

取消暂存某个文件，不会删除文件：

git restore --staged 文件路径

示例：

git restore --staged 其他/临时素材/

取消所有暂存，不会删除文件：

git restore --staged .

6.6 commit 写错了怎么办

如果还没有 Push，可以补一个新的修正提交，最简单安全：

git add .
git commit -m "fix: 组长 修正目录说明"

如果已经 Push，不要为了改提交说明去重写历史。直接下一次按规范写。

6.7 push 失败怎么办

先执行：

git pull

再执行：

git push

如果仍然失败，截图发给组长或老师，不要使用：

git push --force

注意：本地 Commit 只是保存到自己电脑；Push 后 Gitea 仓库才看得到。

7. 提交说明格式

格式：

类型: 姓名 动作 成果 版本

示例：

docs: 张三 提交清洗过程说明v1
docs: 李四 更新指标字典v2
feat: 王五 新增看板截图说明v1
fix: 赵六 修正外链登记

常用类型：

类型 用途
docs: 文档、报告、说明、外链登记
feat: 新增代码、脚本、看板、功能
fix: 修正错误
chore: 整理目录、改文件名

8. 外链怎么提交

大文件不要放进 Git 仓库。先上传到指定平台或网盘，再把链接写进自己的外链登记文件。

示例：

其他/外链登记/LZ-组1_张三_外链登记.md
答辩/外链登记/LZ-组1_张三_答辩外链登记.md

外链登记写法见 外链登记模板。

9. 出错时怎么办

遇到以下情况，不要乱点覆盖：

  • Pull 失败。
  • Push 失败。
  • 出现 conflict / 冲突。
  • Gitea 提示文件已被别人修改。
  • 软件提示覆盖、丢弃、本地修改。
  • 文件突然变红或出现感叹号。

正确做法：

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

不要点：

  • Force Push。
  • Reset。
  • Delete。
  • Revert。
  • Resolve using theirs / mine，除非组长已经确认应该保留哪一方内容。

10. 推荐场景

场景 推荐方式
队员提交一个个人过程记录 Gitea 网页提交
队员提交一个外链登记 Gitea 网页提交
组长初始化大量目录和模板 命令行 git add .
组长只提交某个目录 命令行 git add 目录/
不确定自己改了哪些文件 先 git status
不确定暂存了哪些文件 git diff --cached --name-only