Push
提交并推送更改到当前分支。
此技能不限定特定分支——它始终在当前检出的分支上操作。根据项目对提交归属的偏好,调整下面第8步中的尾行。
快速开始
- 使用
git branch --show-current检测当前分支。 - 如果没有当前分支名,则停止并上报错误。
- 使用
git pull --ff-only origin <当前分支>拉取最新的origin/<当前分支>。如果失败,则停止并上报错误。 - 在暂存前检查差异。
- 优先使用
docs/change-log.md中最新的有意义更新作为提交消息来源(如果相关)。 - 如果更新日志的变更不是更改的真正来源,则从差异中的主要更改区域推导消息。
- 使用
git add -A暂存所有更改。 - 提交时使用多行消息,并追加项目的标准尾行(通常是
Co-Authored-By:行或类似归属;项目特定)。 - 使用
git push origin <当前分支>推送。 - 用一句话报告分支、提交哈希和主题。
提交消息指导
使用简洁的约定式主题,例如:
docs:用于文档或路由更新feat:用于新功能、系统或内容fix:用于行为修正refactor:用于结构变化但不改变主要行为test:用于有意义的测试范围新增或修订chore:用于不适合其他分类的维护工作
对于正文:
- 总结最有意义的更改区域
- 每个主要更改最好一行
- 保持与实际差异一致
当使用 docs/change-log.md 作为来源时:
- 优先选择最新且实际描述核心更改的有意义部分或条目
- 当更新日志的修改是附带性的时,不要强制使用从更新日志派生的消息
当不使用更新日志作为来源时:
- 从差异中最重要的更改区域推导主题
- 如果差异过于模糊无法自信总结,请询问用户提交消息,而不是猜测
规则
- 始终使用当前检出的分支。
- 切勿使用
--force或--force-with-lease。 - 切勿使用
--no-verify。 - 大声失败:如果某一步骤失败,停止并上报错误。