Gitee代码提交全流程与团队协作规范指南

1. Gitee代码提交全流程指南

国内开发者最常用的代码托管平台Gitee（码云）已经成为团队协作和个人项目管理的标配工具。作为一个从SVN时代走过来的老码农，我见证了从本地版本控制到云端协作的完整演进过程。相比GitHub，Gitee的国内访问速度和中文界面对新手更加友好，但很多开发者在日常提交代码时仍然会遇到各种"坑"。

上周帮团队新人排查一个提交冲突问题时，发现他居然手动复制文件到仓库目录——这让我意识到很多基础操作其实需要系统化的指导。本文将结合15个典型场景，从仓库创建到冲突解决，手把手带你掌握Gitee代码提交的完整工作流。

重要提示：所有命令行操作均在Git Bash环境下测试通过，Windows用户建议安装Git for Windows获取完整环境

1.1 环境准备与仓库初始化

在开始提交代码前，需要完成三个基础准备步骤：

1. 安装Git客户端：

   • Windows系统推荐下载Git for Windows
   • macOS用户通过Homebrew安装：brew install git
   • Linux用户使用系统包管理器（如apt-get install git）

2. 配置全局身份信息：

   bash复制git config --global user.name "你的姓名"
   git config --global user.email "公司邮箱"
   

   这信息会记录在每次提交中，建议使用真实工作邮箱

3. 创建Gitee仓库：

   • 登录Gitee官网点击"新建仓库"
   • 建议勾选初始化README.md（方便立即克隆）
   • 私有项目选择"私有"可见性
   • 记住仓库HTTPS/SSH地址（如git@gitee.com:username/project.git）

1.2 首次提交完整流程

对于新项目，标准的首次提交应该遵循以下步骤：

bash复制# 克隆远程仓库到本地
git clone git@gitee.com:username/project.git
cd project

# 创建新分支（非必须但推荐）
git checkout -b feature-add-login

# 添加项目文件到工作区
touch main.py
git add .

# 提交到本地仓库
git commit -m "feat: 添加用户登录模块"

# 推送到远程仓库
git push -u origin feature-add-login

常见问题：如果遇到permission denied错误，检查SSH密钥是否已添加到Gitee账户设置中

2. 日常提交中的高阶技巧

2.1 提交信息规范实践

好的提交信息能让团队协作效率提升50%。推荐使用Angular提交规范：

• feat：新功能（feature）
• fix：bug修复
• docs：文档变更
• style：代码格式调整
• refactor：代码重构
• test：测试用例修改
• chore：构建过程或辅助工具变更

示例：

bash复制git commit -m "feat(user): 添加手机号验证功能

- 集成阿里云短信API
- 增加验证码有效期检查
- 添加失败重试机制"

2.2 部分文件提交策略

当需要选择性提交文件时，推荐使用交互式添加：

bash复制git add -p

这时会进入交互模式，可以：

• 按s拆分大块变更
• 按y/n决定是否暂存当前块
• 按e手动编辑变更块

对于IDE用户（如IntelliJ IDEA）：

1. 在Commit窗口勾选要提交的文件
2. 右键选择"Show Diff"预览变更
3. 使用"Move to Another Changelist"分类管理

2.3 撤销提交的三种场景

1. 撤销工作区修改：

   bash复制git checkout -- filename
   

2. 撤销暂存区文件：

   bash复制git reset HEAD filename
   

3. 撤销已提交的版本：

   • 如果未push到远程：

     bash复制git reset --soft HEAD~1  # 保留修改
     git reset --hard HEAD~1  # 彻底删除
     

   • 如果已push到远程：

     bash复制git revert HEAD  # 生成反向提交
     git push
     

3. 团队协作中的提交规范

3.1 分支管理策略

推荐采用Git Flow变种模型：

code复制main        - 生产环境代码（保护分支）
release/*   - 预发布分支
develop     - 集成测试分支
feature/*   - 功能开发分支
hotfix/*    - 紧急修复分支

创建功能分支示例：

bash复制git checkout -b feature/user-auth develop

合并到develop前需要：

1. 执行git pull --rebase更新代码
2. 解决可能的冲突
3. 确保通过CI流水线

3.2 Code Review提交流程

1. 开发者在本地完成功能开发
2. 推送到个人远程分支：

   bash复制git push origin feature/add-payment
   

3. 在Gitee创建Pull Request：
   • 选择正确的目标分支（通常为develop）
   • 填写变更说明和关联Issue
   • 指定Reviewers审阅人
4. 根据评论修改后追加提交：

   bash复制git commit --amend  # 修改上次提交
   git push -f         # 强制更新
   

注意：强制推送(-f)仅限个人分支使用，共享分支禁止使用

3.3 提交冲突解决方案

当多人修改同一文件时，典型解决流程：

bash复制# 先拉取最新代码
git pull origin develop

# 出现冲突时Git会标记冲突文件
# 手动编辑文件解决冲突（搜索"<<<<<<<"标记）
# 添加解决后的文件
git add conflicted_file.py

# 继续合并
git commit
git push

使用IDE可视化解冲突更高效：

• VS Code：安装GitLens扩展
• IntelliJ IDEA：右键冲突文件选择"Resolve Conflicts"
• Eclipse：使用Team Synchronize视图

4. 企业级提交管控方案

4.1 Git Hook实现提交检查

在.git/hooks目录下创建pre-commit文件：

bash复制#!/bin/sh

# 检查提交信息格式
MSG=$(git log -1 --pretty=%B)
if ! echo "$MSG" | grep -qE "^(feat|fix|docs|style|refactor|test|chore)\(.*\): .{10,}"; then
  echo "ERROR: 提交信息不符合规范!"
  echo "示例: feat(user): 添加登录功能"
  exit 1
fi

# 运行代码检查
npm run lint || exit 1

记得给文件添加执行权限：

bash复制chmod +x .git/hooks/pre-commit

4.2 使用Gitee企业版进行管控

1. 分支保护规则：

   • 设置main分支为保护分支
   • 要求Pull Request才能合并
   • 必须通过CI流水线
   • 需要指定数量审批

2. 提交签名验证：

   bash复制# 生成GPG密钥
   gpg --full-generate-key
   
   # 配置Git使用签名
   git config --global user.signingkey YOUR_KEY_ID
   git config --global commit.gpgsign true
   
   # 将公钥上传到Gitee账户
   gpg --armor --export YOUR_KEY_ID
   

4.3 提交统计与代码审计

1. 查看成员提交量：

   bash复制git shortlog -sn --all
   

2. 导出提交记录到Excel：

   bash复制git log --pretty=format:"%h,%an,%ad,%s" --date=iso > commits.csv
   

3. 统计代码行数变化：

   bash复制git log --author="username" --pretty=tformat: --numstat \
   | awk '{ add += $1; subs += $2; loc += $1 - $2 } END { printf "added: %s, removed: %s, total: %s\n", add, subs, loc }'
   

5. 典型问题排查手册

5.1 提交被拒绝错误分析

错误信息：

code复制[session-224edf8b] reject by [gitee]

可能原因及解决方案：

5.2 提交历史修改方法

需要修改历史提交信息时：

1. 交互式变基：

   bash复制git rebase -i HEAD~3  # 修改最近3次提交
   

   将pick改为edit，保存后修改

2. 修改提交信息：

   bash复制git commit --amend
   

3. 继续变基：

   bash复制git rebase --continue
   

警告：已push到远程的提交不要修改，除非是私有分支

5.3 跨仓库提交技巧

当需要将A仓库代码提交到B仓库：

bash复制# 添加远程仓库别名
git remote add gitee git@gitee.com:new/project.git

# 推送特定分支
git push gitee feature/login

# 或者合并两个不相关历史
git checkout --orphan new-branch
git commit -m "初始化提交"
git push gitee new-branch

对于IntelliJ IDEA用户：

1. 右键项目选择Git > Manage Remotes
2. 添加新的远程仓库URL
3. 推送时选择目标仓库

6. 自动化提交与集成

6.1 Jenkins自动提交配置

在Jenkinsfile中添加提交步骤：

groovy复制stage('Commit Changes') {
    steps {
        script {
            withCredentials([usernamePassword(
                credentialsId: 'gitee-account',
                usernameVariable: 'GIT_USERNAME',
                passwordVariable: 'GIT_PASSWORD'
            )]) {
                sh '''
                    git config user.name "Jenkins"
                    git config user.email "jenkins@company.com"
                    git add .
                    git commit -m "CI: 自动更新配置文件"
                    git push https://${GIT_USERNAME}:${GIT_PASSWORD}@gitee.com/user/repo.git HEAD:develop
                '''
            }
        }
    }
}

6.2 GitHub Actions同步到Gitee

创建.github/workflows/sync.yml：

yaml复制name: Sync to Gitee

on: [push]

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
        with:
          persist-credentials: false

      - name: Mirror to Gitee
        run: |
          git remote add gitee git@gitee.com:yourname/repo.git
          git push gitee HEAD:main
        env:
          GIT_SSH_COMMAND: 'ssh -i ${{ secrets.GITEE_SSH_KEY }}'

6.3 提交触发自动部署

结合Gitee Pages实现文档自动发布：

1. 在仓库设置中开启Gitee Pages服务
2. 创建.gitee/ci.yml：

yaml复制version: "1.0"

pages:
  stage: deploy
  script:
    - mkdocs build
    - touch public/.nojekyll
  only:
    - main

这样每次推送到main分支就会自动构建发布

7. 可视化工具操作指南

7.1 VS Code提交流程

1. 安装GitLens扩展
2. 在源代码管理视图（Ctrl+Shift+G）：
   • 暂存更改：点击文件旁的+
   • 提交：输入信息后点击√
   • 推送：点击同步更改按钮
3. 解决冲突：
   • 冲突文件会显示在"合并更改"区域
   • 使用内置的三方合并工具编辑

7.2 IntelliJ IDEA提交技巧

1. 部分提交：

   • 在Commit窗口（Ctrl+K）
   • 右键文件选择"Split Into Chunks"
   • 勾选要提交的代码块

2. 修改历史提交：

   • 打开Git日志（Alt+9）
   • 右键提交选择"Interactively Rebase from Here"
   • 选择要修改的提交点击Edit

3. cherry-pick：

   • 在日志中右键提交
   • 选择"Cherry-Pick"
   • 解决可能的冲突

7.3 Eclipse EGit操作

1. 提交对话框（Ctrl+#）：

   • 输入提交信息
   • 勾选"Signed-off-by"
   • 点击"Commit and Push"

2. 分支管理：

   • 右键项目 > Team > Switch To > New Branch
   • 创建功能分支

3. 解决冲突：

   • 冲突文件会有特殊标记
   • 右键选择"Merge Tool"
   • 使用比对编辑器调整

8. 移动端提交方案

8.1 使用Working Copy（iOS）

1. 克隆仓库：

   • 添加Gitee仓库URL
   • 选择SSH或HTTPS认证
   • 指定本地存储位置

2. 提交更改：

   • 在文件浏览器中编辑代码
   • 返回主界面查看更改
   • 输入提交信息并提交

3. 推送更新：

   • 滑动仓库卡片选择"Push"
   • 需要网络连接时自动同步

8.2 使用MGit（Android）

1. 仓库管理：

   • 点击"+"添加仓库
   • 输入HTTPS克隆URL
   • 设置认证信息

2. 命令行模式：

   • 支持大部分Git命令
   • 可以执行复杂操作如rebase

3. 冲突解决：

   • 内置合并工具
   • 支持三方文件比对

9. 提交策略优化建议

9.1 原子化提交原则

好的提交应该：

• 只解决一个问题
• 包含完整的逻辑变更
• 能够独立构建测试
• 提交信息明确具体

反模式：

• "修复各种bug"
• "周五的修改"
• "临时提交"

9.2 提交频率把控

推荐策略：

• 功能开发：每天2-3次有意义提交
• bug修复：每个修复独立提交
• 文档更新：集中一次提交
• 紧急修复：立即提交并标记

9.3 大型文件处理

对于超过100MB的文件：

1. 使用Git LFS：

   bash复制git lfs install
   git lfs track "*.psd"
   git add .gitattributes
   

2. 或者添加到.gitignore：

   code复制# 忽略大文件
   /assets/videos/*
   

3. 使用子模块分离资源库

10. 安全提交规范

10.1 敏感信息防护

禁止提交的内容：

• 密码/API密钥
• 配置文件中的数据库连接串
• 私钥文件
• 个人身份信息

解决方案：

1. 使用环境变量：

   python复制import os
   db_pass = os.getenv('DB_PASSWORD')
   

2. 添加至.gitignore：

   code复制config/local.ini
   *.key
   

10.2 提交签名验证

1. 生成GPG密钥：

   bash复制gpg --full-generate-key
   

2. 配置Git使用签名：

   bash复制git config --global user.signingkey YOUR_KEY_ID
   git config --global commit.gpgsign true
   

3. 导出公钥上传到Gitee

10.3 仓库安全设置

1. 分支保护规则：

   • 要求Pull Request
   • 需要代码所有者审核
   • 必须通过CI检查

2. 提交者权限控制：

   • 主仓库只对核心成员开放写权限
   • 其他成员通过fork+PR协作

3. 定期审计日志：

   bash复制git log --since="1 month ago" --pretty=format:"%h %an %ad %s"
   

11. 高级提交场景解析

11.1 多仓库同步提交

当需要同时提交到GitHub和Gitee：

1. 添加多个远程仓库：

   bash复制git remote add github git@github.com:user/repo.git
   git remote add gitee git@gitee.com:user/repo.git
   

2. 设置推送URL：

   bash复制git remote set-url --add --push origin git@github.com:user/repo.git
   git remote set-url --add --push origin git@gitee.com:user/repo.git
   

3. 一次推送到所有仓库：

   bash复制git push origin main
   

11.2 子模块更新提交

对于包含子模块的项目：

1. 初始化子模块：

   bash复制git submodule update --init
   

2. 更新子模块引用：

   bash复制cd submodule_dir
   git checkout main
   git pull
   cd ..
   git add submodule_dir
   git commit -m "更新子模块到最新版本"
   

3. 克隆包含子模块的项目：

   bash复制git clone --recurse-submodules git@gitee.com:user/repo.git
   

11.3 大仓库提交优化

当仓库体积过大时：

1. 使用浅克隆：

   bash复制git clone --depth 1 git@gitee.com:user/repo.git
   

2. 清理历史文件：

   bash复制git filter-branch --tree-filter 'rm -f large_file.zip' HEAD
   

3. 使用git repack：

   bash复制git repack -a -d --depth=250 --window=250
   

12. 提交数据分析技巧

12.1 统计个人贡献量

bash复制git log --author="yourname" --since="1 month ago" --pretty=format: --numstat \
| awk '{ add += $1; subs += $2; loc += $1 - $2 } END { printf "新增: %s, 删除: %s, 净增: %s\n", add, subs, loc }'

12.2 生成提交热力图

使用gitstats工具：

bash复制pip install gitstats
gitstats /path/to/repo /output/dir

12.3 查找高频修改文件

bash复制git log --name-only --pretty=format: | sort | uniq -c | sort -nr | head -10

13. 企业级解决方案

13.1 提交信息模板

在.gitmessage文件中定义模板：

code复制# [类型]: [模块] 简短描述 (不超过50字)

# 详细说明（为什么修改，解决了什么问题）

# 影响范围（哪些功能或模块会受影响）

# 关联Issue（如#123）

然后配置Git使用模板：

bash复制git config --global commit.template ~/.gitmessage

13.2 自动化检查流水线

使用pre-commit框架：

1. 安装pre-commit：

   bash复制pip install pre-commit
   

2. 创建.pre-commit-config.yaml：

   yaml复制repos:
     - repo: https://gitee.com/mirrors/pre-commit-hooks
       rev: v3.4.0
       hooks:
         - id: trailing-whitespace
         - id: end-of-file-fixer
         - id: check-yaml
         - id: check-added-large-files
   

3. 安装钩子：

   bash复制pre-commit install
   

13.3 提交看板集成

与项目管理工具（如禅道）集成：

1. 在提交信息中引用任务：

   bash复制git commit -m "fix: 修复登录页面样式问题 ref T1234"
   

2. 配置Webhook自动更新任务状态

3. 使用API获取提交关联的任务

14. 特殊场景处理方案

14.1 二进制文件差异提交

对于经常变更的二进制文件（如Excel）：

1. 配置diff工具：

   bash复制git config diff.xls.textconv "xlsx2csv -a"
   echo "*.xlsx diff=xls" >> .gitattributes
   

2. 使用Git LFS管理：

   bash复制git lfs track "*.xlsx"
   git add .gitattributes
   

14.2 历史提交清理

永久删除敏感文件：

bash复制git filter-branch --force --index-filter \
  "git rm --cached --ignore-unmatch config/db.ini" \
  --prune-empty --tag-name-filter cat -- --all

强制推送到远程：

bash复制git push origin --force --all

警告：此操作会重写历史，确保团队其他成员知晓

14.3 跨平台换行符处理

统一换行符风格：

bash复制# 提交时转换为LF，检出时不转换
git config --global core.autocrlf input

# 或者完全禁用转换
git config --global core.autocrlf false

在.gitattributes中指定：

code复制* text=auto
*.sh text eol=lf
*.bat text eol=crlf

15. 持续学习资源推荐

15.1 官方文档

• Gitee帮助中心
• Git官方文档
• GitHub Git备忘单

15.2 进阶教程

• 《Pro Git》中文版（免费在线阅读）
• Gitee上的开源项目git-tips
• 廖雪峰的Git教程

15.3 实用工具

1. tig：终端Git浏览器

   bash复制brew install tig  # macOS
   apt-get install tig  # Ubuntu
   

2. lazygit：终端GUI工具

   bash复制go install github.com/jesseduffield/lazygit@latest
   

3. Git Graph（VS Code扩展）：可视化提交历史

在实际项目开发中，我发现最影响团队效率的往往不是复杂的技术问题，而是最基本的代码提交规范。曾经有个项目因为提交信息混乱，导致排查一个历史bug花了整整两天时间。从那以后，我在每个新项目开始前都会花10分钟和团队统一提交规范——这个时间投入的回报率可能高达1000%。