一、简短单行git commit -m 简短描述——不适合放大量文字-m参数只能写简短摘要不适合长篇说明命令行输入一大段文字极易转义、换行、引号出错Git 规范约定第一行是50字符以内简短标题正文详细说明换行隔开工具GitHub PR、日志、IDE展示commit列表只会截断第一行长文本可读性极差。二、长篇详细说明不带-m直接git commit——专门用来放大量说明标准做法直接执行gitcommit会唤起系统默认文本编辑器vim/nano/notepad可以自由写多行、分段、列表、完整变更说明这是 Git 官方推荐的规范写法。标准规范格式50/72法则第一行50字符以内一句话概括改动标题 空一行隔开 下面写大量详细说明 - 改了哪些文件、模块 - 为什么改背景、需求、修复的issue - 实现逻辑、兼容影响、注意事项 - 测试步骤、关联Issue编号 #123 可以分段落、列清单随便写多长三、两种提交方式对比方式适用场景能否大量说明git commit -m xxx极小改动、一句话能说清❌ 不推荐长篇git commit唤起编辑器功能重构、大版本、Bug深度修复、Release变更✅ 最优方案四、补充实用技巧不想弹出编辑器又想写多行不推荐超长仅临时gitcommit-mfeat: 自动打包修复-m1. 删除原仓库白名单判断2. 开启release写入权限3. 新增手动触发工作流多个-m会自动换行但排版受限复杂变更还是用编辑器更好。事后修改已有commit文案# 修改最近一次提交的说明gitcommit--amend执行后同样会打开编辑器可完整重写全部说明。查看完整commit说明# 看单次提交完整内容含长篇正文gitshow 提交哈希# 日志展示完整正文gitlog--prettyfull4.退出编辑器gitcommit打开的是vim编辑器先按ESC然后按:wq回车就能退出编辑器了五、结合你 Fork 打包场景举例你修改自动发布 workflow 这种改动非常适合长篇commit说明推荐操作git add .保存修改直接git commit打开编辑器填写规范文案示例fix: 修复fork仓库无法自动构建Release 解决fork后Actions不自动打包安装包问题 1. 删除workflow中原仓库白名单判断 github.repository 限制 2. 调整权限配置说明需开启仓库Actions读写权限 3. 新增 workflow_dispatch 支持页面手动触发打包 4. 补充缺失secrets密钥配置提示 关联场景Fork仓库Releases页面无自动构建产物保存退出完成提交日志会完整保留全部说明后续查改动、提PR别人也能看懂。总结少量一句话用git commit -m大量、分段、结构化详细说明必须直接git commit编辑器模式这是Git设计出来专门承载长篇变更记录的方式。
