#Git Git 版本管理最佳实践和工作流程指南。 ## 提交消息约定 ### 使用常规提交提交消息遵循格式“: ”：壮举：将表单验证添加到登录页面修复：防止注册时重复的电子邮件检查错误文档：将安装指南添加到自述文件中重构：将身份验证逻辑提取到单独的模块中测试：添加支付功能测试杂务：更新依赖项 #### 主要类型类型 |描述 |例子 ---|---|--- `壮举` |添加新功能 | `壮举：添加暗模式支持` `修复` |错误修复 | `修复：防止注销时删除令牌` `文档` |文档更改（无代码更改）| `docs：更新 API 文档` `风格` |代码格式化，缺少分号（更改行为 X） | `样式：应用 ESLint 规则` `重构` |重构（无功能变化）| `重构：提取实用函数` `测试` |添加/编辑测试代码 | `测试：添加登录API测试` `家务` |构建，更改设置（不更改 src）| `杂务：更新 Webpack 配置` `性能` |性能改进| `perf：实现图像延迟加载` ####详细格式（可选） <类型>（<范围>）：<主题> <正文> <页脚> 示例： feat(auth)：实现基于 JWT 的身份验证 - 发出访问和刷新令牌 - 在Redis中存储刷新令牌 - 添加令牌更新API端点关闭 #123 #### 常见错误 # ❌ 类型缺失 git commit -m“错误修复” # ❌ 描述不明确 git commit -m“修复：修复问题” # ❌ 一次提交多个任务 git commit -m“功能：实现登录、注册和密码重置” # ✅ 明确且单一的责任 git commit -m“壮举：将表单验证添加到登录页面” ### 编写提交消息的指南 1. **第一行应少于 50 个字符** \- 简洁摘要 2. **现在时的使用** \- "added" (X) → "add" (O) 3. **祈使语气** \- "adds" (X) → "add" (O) 4. **第一个字母小写** \- `feat:` (X) → `feat:` (O) 5. **无句点** \- `feat: 添加功能。` (X) → `feat: 添加功能` (O) 6. **正文每 72 个字符就有一个换行符** \- 提高了可读性 7. **Why > What** \ - 解释改变的原因而不是改变的内容。 8. **用英文编写** \- 为了与发行说明生成工具兼容 ## GitHub Flow 工作流程 ### 分支策略主要（始终可部署） ├── 功能/登录表单 ├── 修复/支付错误 └── 重构/用户服务 #### 默认分支创建新存储库时，使用“main”作为默认分支（而不是过去的“master”）： # 初始化新存储库时，从主分支开始 git init -b 主要 # 或者更改现有存储库中的默认分支 git分支-m主主 git push -u 起源主要 # Git 全局设置（适用于所有新存储库） git config --global init.defaultBranch main **注意**：从 2020 年开始，大多数 Git 托管服务（例如 GitHub、GitLab 和 Bitbucket）将使用默认分支作为“main”。 #### 分支命名 # 格式：<类型>/<描述> 功能/用户身份验证修复/标题布局错误重构/支付模块文档/api 文档测试/用户服务杂务/更新依赖项 ### 工作流程 # 1.从main获取最新状态 git 切换主干 git pull origin 主要 # 2.创建一个新分支 git switch -c 功能/暗模式 # 3.下班后承诺 git 添加 . git commit -m“壮举：添加暗模式切换按钮” # 4.推送到远程分支 git push origin 功能/暗模式 # 5. 在 GitHub 上创建 PR gh pr create --title "feat: 添加暗模式支持" --body "..." ＃6。代码审查后合并到 main （GitHub UI 或 CLI） gh pr merge --squash # 或 --merge, --rebase # 7. 更新本地main并删除分支 git 切换主干 git pull origin 主要 git分支-d功能/暗模式 ### PR合并策略战略|描述 |何时使用 ---|---|--- **壁球** |将所有提交合并为一个 |功能分支（推荐） **合并** |创建合并提交，保留历史记录 |发布分支 **变基** |维护线性历史记录，合并提交简单的更改，干净的历史记录 # Squash（推荐 - 按功能组织提交） gh pr 合并 123 --squash # 合并（历史保存） gh pr 合并 123 --merge # 变基（线性历史） gh pr 合并 123 --rebase ## Git历史管理 ###变基 #### 交互式变基（提交清理） # 修改最近3次提交 git rebase -i HEAD~3 # 在编辑器中选择命令 # 选择 → 保持提交 # 改写 → 编辑提交消息 # 编辑 → 编辑提交 # 挤压 → 与之前的提交合并 # 修复 → 合并到之前的提交（删除消息） # drop → 删除提交示例： #之前 pick a1b2c3d feat: 实现登录功能 pick d4e5f6g 修复：变量名称中的拼写错误选择 g7h8i9j 修复：为清楚起见重命名变量 # 之后（使用壁球） pick a1b2c3d feat: 实现登录功能修复 d4e5f6g 修复：变量名称中的拼写错误修复 g7h8i9j 修复：为了清晰起见，重命名变量 #### 重新定位到主干（分支更新） # 1.主要更新 git 切换主干 git pull origin 主要 # 2. 将功能分支重新设置为主分支 git 切换功能/我的功能 git rebase 主要 # 3.发生崩溃时 # - 修改文件后 git 添加 . git rebase --继续 # - 如果你想取消变基 git rebase --abort ### Cherry-pick（仅获取特定提交） # 仅应用另一个分支的一次提交 gitcherry-pick <提交哈希> # 应用多个提交 gitcherry-pick

# 发生碰撞时 git 添加 . gitcherry-pick--继续 ### Commit Amend（修改上次提交） # 只修改最后的提交消息 git commit --amend -m“修复：正确的提交消息” # 将文件添加到最后一次提交 git add 被遗忘的文件.ts git commit --修改 --no-edit # ⚠️ 注意：不要修改已经推送的提交（历史将会改变） ### 重置与恢复 # Reset - 取消提交（删除历史记录） git reset --soft HEAD~1 # 仅取消提交，保留更改 git reset --mixed HEAD~1 # 提交+取消暂存，保留更改（默认） git reset --hard HEAD~1 # 提交+删除所有更改（危险！） # ⚠️ 禁止重置推送的提交 → 使用恢复 # 恢复 - 创建一个新的提交来恢复提交（保留历史记录） git revert <提交哈希> git revert HEAD # 恢复上次提交 ## 解决合并冲突 ### 冲突发生场景 # 合并或变基 main 时发生冲突 git 合并主干 # 或 git rebase 主要 # 自动合并 src/index.ts # CONFLICT (content): src/index.ts 中的合并冲突 ### 冲突解决流程 # 1.检查冲突文件 git 状态 # 2.打开文件并手动编辑 # <<<<<<< HEAD（当前分支） # 我的改变 # ======= # 相关分支的变化 # >>>>>>> 主要 # 3.删除标记并修改代码 # 4. 暂存已解析的文件 git add src/index.ts # 5.合并完成 git 合并——继续 # 或继续 Rebase git rebase --继续 ### 冲突解决策略 # 对当前分支的更改优先 git Restore --ours <文件> # 对相关分支的更改优先 git Restore --theirs <文件> # 取消合并 git 合并——中止 # 取消变基 git rebase --abort ## 常用命令 ### 分支操作（git switch） # 切换到现有分支 git 切换主干 git 切换功能/我的功能 # 创建新分支+切换 git switch -c 功能/新功能 # 返回上一个分支 git 开关 - # 跟踪和切换远程分支 git switch -c 本地分支原点/远程分支 **注意**：从 Git 2.23+（2019 年 8 月）开始使用 `git switch`。现有的“git checkout”引起了混乱，因为它承担了多个角色，例如分支切换和文件恢复。 `git switch` 只负责分支切换。 ### 恢复文件（git 恢复） # 恢复工作目录文件（撤消未暂存的更改） git 恢复 <文件> # 取消暂存（恢复为未暂存） git 恢复 --staged <文件> # 恢复工作目录+暂存目录 git Restore --staged --worktree <文件> # 从特定提交恢复到文件 git Restore --source=<提交哈希> <文件> **注意**： `git Restore` 是专用于恢复文件的命令。替换现有的 `git checkout -- `。 ### 检查状态 git status # 检查更改 git log --oneline # 提交历史记录（一行） git log --graph # 分支图 git diff # 检查更改 git diff --staged # 分阶段更改 git show # 查看具体提交详情 ### Stash（临时存储） git stash # 暂时保存当前工作 git stash list # 保存的存储列表 git stash pop # 应用最后的存储 + 删除 git stash apply # 应用（维护）最后一个存储 git stash drop # 删除最后一个存储 git stash clear # 删除所有存储 ### 远程存储库 git remote -v # 查看远程仓库 git fetch origin # 获取远程更改（合并 X） git pull origin main # 拉取远程更改+合并 git push origin main # 推送本地更改 git push -f origin main # 强制推送（⚠️危险 - 团队工作时禁止） ## 注意事项（反模式） ### 在当前目录中不必要地使用 `git -C` # ❌ 当前目录为目标仓库，但使用了-C选项。 git -C /path/to/current/repo log --oneline # ✅ 直接从当前目录运行 git log --oneline 如果当前目录与目标存储库相同，则`git -C`选项是不必要的冗余。仅当将存储库定位到不同路径时才使用。 ## 安全和预防措施 ### 永远不应该提交的文件 # 添加到.gitignore .env # 环境变量（API 密钥、密码） .env.local *.key # 证书密钥 *.pem Secrets/ # 秘密目录 node_modules/ # 依赖项（由 package.json 管理） dist/# 构建输出 .DS_Store # macOS 系统文件 ### 删除意外犯下的秘密 # ⚠️ 从历史记录中完全删除（使用 BFG 而不是 git filter-branch）酿造安装bfg bfg --delete-files.env git reflog expire --expire=now --all && git gc --prune=now --aggressive # ⚠️注意：如果您已经推送过，必须立即丢弃该秘密并重新发布。 ### 无强制推送（共享分支） # ❌ 绝对禁止强制推送 main/develop git push -f 起源主要 # ✅ 只允许在私有功能分支上 git push -f 原始功能/我的分支 ## 使用 GitHub CLI # 创建公关 gh pr create --title "feat: 添加新功能" --body "描述..." # 查看PR列表 gh 公关列表 # 公关细节 gh 公关视图 123 # PR结账（本地测试） gh 公关结账 123 # 公关合并 gh pr 合并 123 --squash # 创建问题 gh issues create --title“发现错误”--body“描述...” ## 附加学习材料 * [常规提交]() * [GitHub Flow]() * [Pro Git 书籍（韩文）]()

git

包含技能