Gitee代码提交全流程与Git环境配置详解

1. Gitee代码提交全流程解析

国内开发者使用Gitee进行代码版本控制时，完整的代码提交流程包含以下几个关键环节：

1. 环境准备阶段

   • Git客户端安装与配置
   • SSH密钥生成与绑定
   • TortoiseGit图形化工具安装（可选）

2. 仓库操作阶段

   • 本地仓库初始化
   • 远程仓库关联
   • 分支管理策略制定

3. 代码提交阶段

   • 工作区到暂存区的变更添加
   • 提交信息的规范化编写
   • 本地提交推送到远程仓库

重要提示：首次使用前需完成账户的SSH Key配置，这是后续所有操作的基础认证环节

2. 环境配置详解

2.1 Git客户端安装

Windows平台推荐使用官方Git for Windows安装包：

# 验证安装是否成功 git --version # 应输出类似：git version 2.40.1.windows.1

配置全局用户信息（必须与Gitee账户一致）：

git config --global user.name "你的姓名" git config --global user.email "注册邮箱"

2.2 SSH密钥配置

1. 生成密钥对（默认保存位置：~/.ssh/）

ssh-keygen -t rsa -C "your_email@example.com"

2. 将公钥(id_rsa.pub)内容添加到Gitee：
   • 登录Gitee → 设置 → SSH公钥
   • 标题建议用"设备名_日期"格式
   • 添加后测试连接：

   ssh -T git@gitee.com

3. 仓库操作实战

3.1 新建仓库场景

1. 在Gitee创建空仓库
2. 本地初始化并关联：

mkdir project && cd project git init git remote add origin git@gitee.com:username/repo.git

3.2 现有项目提交

对于已有项目目录：

cd existing_project git init git add . git commit -m "初始提交" git push -u origin master

4. 日常提交规范

4.1 变更提交流程

推荐的工作流：

# 查看当前变更状态 git status # 添加特定文件到暂存区 git add filename.ext # 或添加所有变更 git add . # 提交到本地仓库 git commit -m "fix: 修复登录页面样式问题" # 推送到远程 git push origin branch_name

4.2 提交信息规范

建议采用Angular风格的提交格式：

<type>(<scope>): <subject> [optional body] [optional footer]

常用type类型：

• feat：新功能
• fix：bug修复
• docs：文档变更
• style：代码格式调整
• refactor：代码重构

5. 图形化工具辅助

5.1 TortoiseGit配置

1. 安装后右键菜单会出现Git相关选项
2. 首次使用需配置：
   • 指定git.exe路径
   • 设置用户信息
   • 配置SSH客户端为Plink

5.2 可视化操作

通过右键菜单可完成：

• 克隆仓库(Clone)
• 提交变更(Commit)
• 查看日志(Show log)
• 创建分支(Create Branch)

6. 常见问题排查

6.1 认证失败问题

错误现象：

Permission denied (publickey)

解决方案：

1. 检查ssh-agent是否运行

   eval $(ssh-agent -s) ssh-add ~/.ssh/id_rsa

2. 确认Gitee公钥配置正确

6.2 冲突解决

当出现冲突时：

1. 拉取最新代码：

   git pull origin branch_name

2. 手动解决冲突文件中的<<<<<<标记
3. 重新提交：

   git add . git commit -m "解决合并冲突" git push

7. 高级技巧

7.1 忽略文件配置

创建.gitignore文件示例：

# 忽略编译产物 *.class *.exe *.dll # 忽略IDE配置 .idea/ .vscode/ # 忽略系统文件 .DS_Store Thumbs.db

7.2 分支管理策略

推荐工作流：

master -> release -> develop -> feature/*

常用命令：

# 创建新分支 git branch new_feature # 切换分支 git checkout branch_name # 合并分支 git merge source_branch

8. WebHook自动化配置

在仓库设置→WebHooks中添加：

• URL：接收POST请求的端点
• 触发事件：选择push等事件
• 密钥：用于验证请求合法性

典型应用场景：

• 自动触发CI/CD流程
• 同步更新测试环境
• 发送通知到钉钉/企业微信

9. 多平台协作建议

1. 定期执行git fetch --all获取远程更新
2. 使用git rebase替代merge保持提交线整洁
3. 复杂功能开发建议使用特性分支
4. 重要合并操作前先创建备份分支

10. 版本回退操作

撤销本地修改：

# 放弃工作区修改 git checkout -- filename # 重置暂存区 git reset HEAD filename # 回退到指定提交 git reset --hard commit_id

找回误删内容：

# 查看历史记录 git reflog # 恢复到指定操作 git reset --hard HEAD@{n}