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。建议在克隆前确认：
- 已安装最新版Git（推荐2.30+版本）
- 配置了正确的用户信息：
git config --global user.name "YourName" git config --global user.email "your@email.com"
2.2 日常开发中的代码提交步骤
典型的代码修改提交流程包含以下环节：
创建或切换到开发分支（避免直接修改main/master分支）
git checkout -b feature/new-function修改代码后查看变更状态
git status将修改添加到暂存区
git add . # 添加所有修改 # 或指定文件 git add src/main.js提交到本地仓库
git commit -m "feat: 实现用户登录验证功能"推送到远程Gitee仓库
git push origin feature/new-function
专业提示：commit message应遵循约定式提交规范（Conventional Commits），便于生成变更日志
2.3 使用IntelliJ IDEA可视化提交
对于使用JetBrains系列IDE的开发者，可以完全通过GUI界面完成提交：
- 在Version Control面板（Alt+9）查看变更文件
- 右键文件选择"Add to VCS"或直接点击"+"
- 填写Commit Message后点击Commit按钮
- 通过Git → Push菜单项推送变更
IDEA还提供：
- 差异对比查看（Ctrl+D）
- 部分文件提交（选择特定文件后再Commit）
- 提交前代码分析（在Commit对话框勾选"Analyze code"）
3. 高级提交场景处理
3.1 处理提交冲突的完整流程
当多人修改同一文件时，push操作可能会被拒绝并提示冲突。解决方法：
先拉取最新代码
git pull origin feature/new-functionIDE会标记冲突文件，手动解决冲突（搜索"<<<<<<<"标记）
重新添加解决后的文件
git add conflicted-file.js继续完成提交
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 选择性提交技巧
有时我们只想提交部分修改而非全部文件：
交互式添加（逐个选择变更片段）
git add -p使用IDE的Partial Commit功能：
- 在IDEA中选中文件的特定变更行
- 右键选择"Commit Selected Lines"
4. Gitee特色功能与最佳实践
4.1 Gitee Pages的自动化部署
Gitee提供静态网站托管服务，可通过提交代码自动更新：
仓库根目录添加
.gitee/conf.yaml：pages: build: npm run build output: dist每次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 提交被拒绝的典型原因
权限不足
- 检查是否被添加为仓库成员
- 确认SSH密钥是否正确配置
分支保护规则限制
- 尝试创建新分支而非直接push到受保护分支
- 联系管理员添加你为白名单用户
存储空间不足
- Gitee免费账户有1GB容量限制
- 使用
git gc清理本地仓库历史
5.2 找回丢失的提交
如果误操作导致提交丢失，可通过以下步骤尝试恢复：
查找丢失的提交哈希
git reflog基于哈希创建新分支
git branch recovery-branch abc1234合并回原分支
git checkout main git merge recovery-branch
5.3 大文件提交失败处理
Gitee默认限制单个文件不超过100MB：
使用Git LFS管理大文件
git lfs install git lfs track "*.psd" git add .gitattributes或配置
.gitignore排除大文件对于历史中的大文件，使用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-auth6.2 代码审查流程优化
在Gitee上配置保护分支规则：
- 要求Pull Request
- 至少1个审核通过
- 需通过CI检查
使用
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)可能导致大量虚假变更：
统一仓库配置：
git config --global core.autocrlf input在项目根目录添加
.gitattributes：* text=auto *.sh text eol=lf
7.2 文件编码规范
建议采用UTF-8编码统一标准：
在IDE中设置项目文件编码：
- IntelliJ IDEA: File → Settings → Editor → File Encodings
- VS Code: 通过
.vscode/settings.json配置
对于历史遗留GBK文件，使用
iconv转换：iconv -f GBK -t UTF-8 src/oldfile.js > src/newfile.js
7.3 多仓库协作方案
当项目依赖多个Gitee仓库时：
使用Git Submodule：
git submodule add https://gitee.com/team/common-lib.git libs/common或采用Monorepo结构，使用工具管理：
- Lerna（JavaScript生态）
- Bazel（大型跨语言项目）
8. 安全与权限管理
8.1 SSH密钥最佳实践
生成ED25519算法密钥（比RSA更安全）：
ssh-keygen -t ed25519 -C "your@email.com"在Gitee账户设置中添加公钥
测试连接：
ssh -T git@gitee.com
8.2 敏感信息防护
绝对禁止提交的内容：
- 密码/API密钥
- 证书私钥
- 配置文件中的数据库连接字符串
解决方案：
使用环境变量管理敏感信息
添加至
.gitignore：/config/secrets.json /.env对于已提交的历史记录，使用
git filter-repo清理：git filter-repo --replace-text <(echo "password==>REDACTED")
8.3 双因素认证配置
在Gitee账户安全设置中启用：
- 手机APP验证（如Google Authenticator）
- 备用验证码下载保存
- 配置可信设备免验证
9. 性能优化技巧
9.1 加速克隆大型仓库
仅克隆最新历史：
git clone --depth=1 https://gitee.com/large-repo.git使用
partial clone过滤不需要的文件：git clone --filter=blob:none https://gitee.com/large-repo.git
9.2 仓库瘦身方法
识别大文件：
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使用BFG清理：
java -jar bfg.jar --strip-blobs-bigger-than 10M my-repo.git强制推送清理后仓库：
git push origin --force --all
9.3 日常维护命令
定期压缩仓库：
git gc --aggressive重新建立索引：
git repack -a -d --depth=250 --window=250检查仓库健康状态：
git fsck --full
10. 与其他平台协同工作
10.1 从SVN迁移到Gitee
创建作者映射文件
authors.txt：svn-user1 = Git User1 <user1@email.com>执行迁移：
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同步
添加GitHub为第二个远程：
git remote add github https://github.com/user/repo.git设置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对比
主要差异点：
| 特性 | Gitee | AtomGit |
|---|---|---|
| 服务器位置 | 中国大陆 | 海外 |
| 访问速度 | 快 | 可能较慢 |
| 开源许可证 | 支持全面 | 有限支持 |
| CI/CD | Gitee Go | GitHub Actions |
| 大文件支持 | Git LFS | 相同 |
| 企业功能 | 完善 | 基础 |
选择建议：国内团队优先Gitee，国际项目考虑AtomGit