ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀，每一条都经过真实交付验证。

首页 / 资讯中心 / 正文

Gitee代码提交全流程与最佳实践指南

2026/8/8 22:07:05 拓冰建站 浏览量
Gitee代码提交全流程与最佳实践指南

1. Gitee代码提交基础概念

Gitee作为国内主流的代码托管平台，其核心功能与GitHub类似但针对国内开发者做了优化。代码提交是日常开发中最频繁的操作之一，理解其完整流程对团队协作至关重要。

Git版本控制系统采用分布式架构，每个开发者本地都拥有完整的仓库副本。提交代码时，实际上是先提交到本地仓库，再通过push操作同步到远程Gitee仓库。这种设计使得开发者可以在离线状态下继续工作，待网络恢复后再同步变更。

注意：Gitee的免费版对私有仓库协作人数有限制（最多5人），企业开发需注意选择合适的套餐

1.1 本地仓库与远程仓库的关系

当我们在Gitee上创建新仓库时，会生成一个远程仓库地址（通常以https://gitee.com/开头）。开发者需要先在本地初始化Git仓库，然后通过git remote add命令将本地与远程仓库建立关联。

常见的两种关联方式：

  • HTTPS协议：适合新手，每次push需要输入账号密码
  • SSH协议：需要配置密钥但操作更安全便捷
# 初始化本地仓库 git init # 添加远程仓库（将<repository-url>替换为实际Gitee仓库地址） git remote add origin <repository-url>

2. 完整代码提交流程详解

2.1 准备工作：环境配置与仓库克隆

对于新加入项目的开发者，首先需要克隆远程仓库到本地：

git clone https://gitee.com/username/repository.git cd repository

克隆完成后会自动创建与远程仓库的关联，无需手动添加remote。建议在克隆前确认：

  1. 已安装最新版Git（推荐2.30+版本）
  2. 配置了正确的用户信息：
    git config --global user.name "YourName" git config --global user.email "your@email.com"

2.2 日常开发中的代码提交步骤

典型的代码修改提交流程包含以下环节：

  1. 创建或切换到开发分支（避免直接修改main/master分支）

    git checkout -b feature/new-function

  2. 修改代码后查看变更状态

    git status

  3. 将修改添加到暂存区

    git add . # 添加所有修改 # 或指定文件 git add src/main.js

  4. 提交到本地仓库

    git commit -m "feat: 实现用户登录验证功能"

  5. 推送到远程Gitee仓库

    git push origin feature/new-function

专业提示：commit message应遵循约定式提交规范（Conventional Commits），便于生成变更日志

2.3 使用IntelliJ IDEA可视化提交

对于使用JetBrains系列IDE的开发者，可以完全通过GUI界面完成提交：

  1. 在Version Control面板（Alt+9）查看变更文件
  2. 右键文件选择"Add to VCS"或直接点击"+"
  3. 填写Commit Message后点击Commit按钮
  4. 通过Git → Push菜单项推送变更

IDEA还提供：

  • 差异对比查看（Ctrl+D）
  • 部分文件提交（选择特定文件后再Commit）
  • 提交前代码分析（在Commit对话框勾选"Analyze code"）

3. 高级提交场景处理

3.1 处理提交冲突的完整流程

当多人修改同一文件时，push操作可能会被拒绝并提示冲突。解决方法：

  1. 先拉取最新代码

    git pull origin feature/new-function

  2. IDE会标记冲突文件，手动解决冲突（搜索"<<<<<<<"标记）

  3. 重新添加解决后的文件

    git add conflicted-file.js

  4. 继续完成提交

    git commit -m "fix: 解决登录验证冲突" git push origin feature/new-function

3.2 修改历史提交的几种方式

情况1：修改最后一次提交

git commit --amend # 修改message后保存退出 git push origin feature/new-function --force

情况2：交互式变基修改多个提交

git rebase -i HEAD~3 # 在编辑器中将pick改为edit # 对每个标记为edit的提交执行： git commit --amend git rebase --continue

警告：修改已推送的历史提交需要使用--force参数，团队协作中应谨慎使用

3.3 选择性提交技巧

有时我们只想提交部分修改而非全部文件：

  1. 交互式添加（逐个选择变更片段）

    git add -p

  2. 使用IDE的Partial Commit功能：

    • 在IDEA中选中文件的特定变更行
    • 右键选择"Commit Selected Lines"

4. Gitee特色功能与最佳实践

4.1 Gitee Pages的自动化部署

Gitee提供静态网站托管服务，可通过提交代码自动更新：

  1. 仓库根目录添加.gitee/conf.yaml：

    pages: build: npm run build output: dist

  2. 每次push到master分支后会自动构建部署

4.2 代码提交统计与分析

Gitee企业版提供丰富的代码统计功能：

  • 成员提交活跃度
  • 代码行数变化趋势
  • 提交时间分布

个人开发者可以通过以下命令获取基础统计：

# 查看所有贡献者提交统计 git shortlog -sn # 查看指定开发者代码行数变化 git log --author="username" --pretty=tformat: --numstat | awk '{ add += $1; subs += $2; loc += $1 - $2 } END { printf "added lines: %s, removed lines: %s, total lines: %s\n", add, subs, loc }'

4.3 开源许可证选择建议

在Gitee创建开源项目时，常见许可证选择：

许可证类型适用场景Gitee推荐指数
MIT允许商用修改，只需保留版权声明★★★★★
Apache 2.0需要专利授权的中大型项目★★★★
GPL-3.0要求衍生作品必须开源★★★
AGPL-3.0云服务场景下的强copyleft★★

建议在项目根目录添加LICENSE文件，并在README中明确声明。

5. 常见问题排查指南

5.1 提交被拒绝的典型原因

  1. 权限不足

    • 检查是否被添加为仓库成员
    • 确认SSH密钥是否正确配置

  2. 分支保护规则限制

    • 尝试创建新分支而非直接push到受保护分支
    • 联系管理员添加你为白名单用户

  3. 存储空间不足

    • Gitee免费账户有1GB容量限制
    • 使用git gc清理本地仓库历史

5.2 找回丢失的提交

如果误操作导致提交丢失，可通过以下步骤尝试恢复：

  1. 查找丢失的提交哈希

    git reflog

  2. 基于哈希创建新分支

    git branch recovery-branch abc1234

  3. 合并回原分支

    git checkout main git merge recovery-branch

5.3 大文件提交失败处理

Gitee默认限制单个文件不超过100MB：

  1. 使用Git LFS管理大文件

    git lfs install git lfs track "*.psd" git add .gitattributes

  2. 或配置.gitignore排除大文件

  3. 对于历史中的大文件，使用BFG工具清理：

    java -jar bfg.jar --strip-blobs-bigger-than 100M my-repo.git

6. 企业级开发规范建议

6.1 分支管理策略

推荐采用Git Flow变种方案：

  • master：生产环境对应分支，仅接受合并请求
  • develop：集成测试分支
  • feature/*：功能开发分支
  • hotfix/*：紧急修复分支

示例创建流程：

git checkout -b feature/user-auth develop # 开发完成后... git checkout develop git merge --no-ff feature/user-auth

6.2 代码审查流程优化

  1. 在Gitee上配置保护分支规则：

    • 要求Pull Request
    • 至少1个审核通过
    • 需通过CI检查

  2. 使用pre-commit钩子自动检查：

    # .pre-commit-config.yaml repos: - repo: https://gitee.com/mirrors/pre-commit-hooks rev: v3.4.0 hooks: - id: trailing-whitespace - id: end-of-file-fixer

6.3 CI/CD集成实践

Gitee提供基于Gitee Go的CI服务，配置示例：

# .gitee-ci.yml stages: - build - test build-job: stage: build script: - npm install - npm run build test-job: stage: test script: - npm run test

关键配置项：

  • 缓存依赖目录加速构建
  • 设置环境变量区分测试/生产环境
  • 配置构建成功后的通知方式

7. 跨平台开发注意事项

7.1 Windows与Unix换行符问题

不同系统默认换行符(CRLF/LF)可能导致大量虚假变更：

  1. 统一仓库配置：

    git config --global core.autocrlf input

  2. 在项目根目录添加.gitattributes：

    * text=auto *.sh text eol=lf

7.2 文件编码规范

建议采用UTF-8编码统一标准：

  1. 在IDE中设置项目文件编码：

    • IntelliJ IDEA: File → Settings → Editor → File Encodings
    • VS Code: 通过.vscode/settings.json配置

  2. 对于历史遗留GBK文件，使用iconv转换：

    iconv -f GBK -t UTF-8 src/oldfile.js > src/newfile.js

7.3 多仓库协作方案

当项目依赖多个Gitee仓库时：

  1. 使用Git Submodule：

    git submodule add https://gitee.com/team/common-lib.git libs/common

  2. 或采用Monorepo结构，使用工具管理：

    • Lerna（JavaScript生态）
    • Bazel（大型跨语言项目）

8. 安全与权限管理

8.1 SSH密钥最佳实践

  1. 生成ED25519算法密钥（比RSA更安全）：

    ssh-keygen -t ed25519 -C "your@email.com"

  2. 在Gitee账户设置中添加公钥

  3. 测试连接：

    ssh -T git@gitee.com

8.2 敏感信息防护

绝对禁止提交的内容：

  • 密码/API密钥
  • 证书私钥
  • 配置文件中的数据库连接字符串

解决方案：

  1. 使用环境变量管理敏感信息

  2. 添加至.gitignore：

    /config/secrets.json /.env

  3. 对于已提交的历史记录，使用git filter-repo清理：

    git filter-repo --replace-text <(echo "password==>REDACTED")

8.3 双因素认证配置

在Gitee账户安全设置中启用：

  1. 手机APP验证（如Google Authenticator）
  2. 备用验证码下载保存
  3. 配置可信设备免验证

9. 性能优化技巧

9.1 加速克隆大型仓库

  1. 仅克隆最新历史：

    git clone --depth=1 https://gitee.com/large-repo.git

  2. 使用partial clone过滤不需要的文件：

    git clone --filter=blob:none https://gitee.com/large-repo.git

9.2 仓库瘦身方法

  1. 识别大文件：

    git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | awk '/^blob/ {print substr($0,6)}' | sort --numeric-sort --key=2 | tail -n 20

  2. 使用BFG清理：

    java -jar bfg.jar --strip-blobs-bigger-than 10M my-repo.git

  3. 强制推送清理后仓库：

    git push origin --force --all

9.3 日常维护命令

  1. 定期压缩仓库：

    git gc --aggressive

  2. 重新建立索引：

    git repack -a -d --depth=250 --window=250

  3. 检查仓库健康状态：

    git fsck --full

10. 与其他平台协同工作

10.1 从SVN迁移到Gitee

  1. 创建作者映射文件authors.txt：

    svn-user1 = Git User1 <user1@email.com>

  2. 执行迁移：

    git svn clone --stdlayout --authors-file=authors.txt https://svn.example.com repo cd repo git remote add gitee https://gitee.com/your/repo.git git push gitee --all

10.2 与GitHub同步

  1. 添加GitHub为第二个远程：

    git remote add github https://github.com/user/repo.git

  2. 设置push默认推送到两个仓库：

    git remote set-url --add --push origin https://gitee.com/user/repo.git git remote set-url --add --push origin https://github.com/user/repo.git

10.3 AtomGit与Gitee对比

主要差异点：

特性GiteeAtomGit
服务器位置中国大陆海外
访问速度快可能较慢
开源许可证支持全面有限支持
CI/CDGitee GoGitHub Actions
大文件支持Git LFS相同
企业功能完善基础

选择建议：国内团队优先Gitee，国际项目考虑AtomGit