# Git 提交规范 > **版本?* v1.1 > **创建日期?* 2025-11-16 > **更新日期?* 2025-11-28 > **适用范围?* 全项目（前端 + 后端 + 文档? > **优先级：** ⭐⭐⭐⭐?P0 必须遵守 --- ## 🚨 紧急警告：必须每日提交? > **🔴🔴🔴 血泪教训：DC模块代码全部丢失事件?025-11-28）🔴🔴?* ### 事件回顾 **时间**?025-11-27 - 2025-11-28 **丢失内容**：DC模块完整代码（约2天开发量?- ?4个Prisma数据表定?- ?4个Service类（HealthCheckService、TemplateService等） - ?Controller和Routes - ?所有TypeScript代码文件 **保留内容**?- ?设计文档（数据库设计、API设计?- ?开发记录（Day2、Day3完成总结?- ?空目录结? **丢失原因**?- ?**代码写完后未提交到Git** - ?**代码仅存在于Cursor临时缓存?* - ?**Cursor缓存清理后，代码永久丢失** - ?**Git中无任何提交记录，无法恢?* ### 🔥 强制规则（立即生效） ```bash # ⭐⭐⭐⭐?每天下班前必须执行（无例外！?git status git add . git commit -m "feat(module): Complete Day X development" git push origin master # ⚠️ 不提?= 代码随时可能丢失?``` **提交时机（任选其一，发生时必须提交）：** 1. ?**每天下班?*（最重要！无论代码是否完美） 2. ?**每次长时间离开电脑?*（午休、会议、外出） 3. ?**完成重要功能?* 4. ?**准备关闭Cursor?* 5. ?**电脑出现异常?*（如卡顿、死机征兆） **绝对禁止?* - 🔴 **禁止**依赖Cursor自动保存（Cursor不保证持久化?- 🔴 **禁止**"稍后再提?（稍后可能就忘记了） - 🔴 **禁止**代码过夜不提交（一夜之间可能丢失） - 🔴 **禁止**"代码还没完善不想提交"（不完善也要提交，总比丢失强） ### 💡 最佳实? **每日工作流（推荐）：** ```bash # 早上开始工?git pull origin master # 拉取最新代? # 开发过程中... # [编写代码、测试功能] # 🔥 每天下班前（强制执行！） git status # 查看修改 git add . # 添加所有修?git commit -m "feat(dc): Complete Day 2 - HealthCheck and Template services Summary: - Implement HealthCheckService with Excel parsing - Implement TemplateService with 3 preset templates - Add 4 Prisma models (dc_health_checks, dc_templates, etc.) - Update documentation Status: Basic functionality verified, ready for testing" git push origin master # 推送到远程 # 现在可以安心下班！代码已安全备份 ?``` **🎯 记住：Git是代码的唯一可靠备份！未提交的代?= 不存在的代码?* --- ## 📋 目录 1. [远程仓库配置](#远程仓库配置) 2. [Commit Message 规范](#commit-message-规范) 3. [提交频率与时机](#提交频率与时? ?重要原则 4. [分支管理策略](#分支管理策略) 5. [中文编码问题解决](#中文编码问题解决) 6. [Git 历史重写与维护](#git-历史重写与维? 7. [代码审查流程](#代码审查流程) 8. [常见问题与最佳实践](#常见问题与最佳实? --- ## 远程仓库配置 ### 🌐 Gitee 仓库信息 **仓库地址?* ``` https://gitee.com/hahafeng117/AIclinicalresearch.git ``` **全局配置?* ```bash git config --global user.name "HaHafeng" git config --global user.email "gofeng117@163.com" ``` **中文编码配置?* ?重要 ```bash # 确保 Git 正确处理中文文件名和提交信息 git config --global core.quotepath false git config --global gui.encoding utf-8 git config --global i18n.commit.encoding utf-8 git config --global i18n.logoutputencoding utf-8 ``` **PowerShell 配置?* ```powershell # ?PowerShell Profile 中添加（$PROFILE 文件?[Console]::OutputEncoding = [System.Text.Encoding]::UTF8 $env:LESSCHARSET = 'utf-8' ``` ### 克隆仓库 ```bash # 初次克隆 git clone https://gitee.com/hahafeng117/AIclinicalresearch.git # 查看远程仓库 git remote -v ``` --- ## Commit Message 规范 ### ⚠️ 重要提示：避免中文乱? **强制要求：Commit Message 必须使用英文** ⭐⭐? **原因**?- Windows PowerShell 环境下，Git commit message 中的中文会出现乱?- 中文乱码会导致提交历史难以阅读，影响团队协作 - 英文 commit message 是国际开源项目的标准实践 **?正确示例?* ```bash git commit -m "feat(asl): Implement full-text screening core service" git commit -m "fix(frontend): Fix dropdown menu click issue" git commit -m "docs: Add development guide for Day 2-3" ``` **?错误示例?* ```bash git commit -m "feat(asl): 实现全文复筛核心服务" # 会出现乱?git commit -m "修复下拉菜单问题" # 会出现乱?``` **例外情况**?- 文件名和文件内容可以使用中文（Git 能正确处?UTF-8 编码的文件） - ?commit message 必须使用英文 --- ### 📝 格式规范 **标准格式?* ``` ():