一个很有意思的问题，你们提交代码时，会要求把 commit msg 写成技术文章不

NoKey · 2026-07-28T01:43:55Z

有个哥们在的项目组要求提交代码时，写出详细的修改如果涉及一个新功能，需要写出详细的实现过程还要画流程图就跟一篇方案设计一样行业内有这么玩的么？

代码

文档

流程

23 replies • 2026-07-28 20:41:24 +08:00

1

YanSeven

11h 22m ago

如果文章也是 ai 写的，图也是 ai 画的，不就是徒增 review 成本么。
没有意义。

2

mooyo

11h 21m ago

现在不都是 AI 写的么

3

Razio

11h 21m ago

是有的人风格就这样，不喜欢写文档，全塞 git commit 。如果是你老板，你叽里咕噜有啥用？人家一言堂

4

dinjufen

11h 20m ago

都是 ai 写的了，commit 也是 ai 写的。即便要实现过程文档，也是 ai 在修改前总结出来再开始改代码的。

5

stringwind

11h 20m ago

挺好的，不耽误工作的前提下，如果不是 ai 生成的话，要花挺久时间的。
如果是 ai 生成的，没有校对，价值不是很大。

6

jenhe

11h 18m ago

这不沙雕么

7

horizon

11h 16m ago

1

沙雕。应该在开发前写，而不是开发完了才开始写

8

coderluan

11h 4m ago

哪怕需要这些，也应该是 commit 指向项目的 task 或者仓库内相关文档，commit 本身写文档存在大量限制，这么做属于自作聪明。

9

IlIl

11h 4m ago

2

我们组一个招的一个哥们每次提交的 commit 都写个 1 ，被说了后改成了改 bug ,新需求，合代码这 3 个循环。。。

10

blakezhaothinks

10h 56m ago

没听过这么玩的，全塞 Commit Message 有点离谱。
我觉得 Commit Message 可以保留简短摘要 + 详细文档的链接（如果真的需要的话）。

11

lyf340010

10h 54m ago

这不成注释了么。

12

94

10h 51m ago

不会，但是会明确要按照 Conventional Commits 形式来提交。如果 header 的描述里面可以简单说清楚就不写正文。

如果是详细说明，是要求在 PRD 中说明，对应开发的部分落在对应模块的 README.md 或者 /doc 目录中。commit 的正文不应该详细描述实现过程。

https://www.conventionalcommits.org/zh-hans/v1.0.0/

13

novaline

10h 51m ago

全过程 AI, 全过程民主

14

zhaiyuxin103

10h 49m ago

用合适的工具做合适的事情，commit msg 显然不适合这样用。

15

udisyue

10h 49m ago via Android

文档是文档，commit 是 commit ，一个是详细说明，一个是提交概要，有毛病才会要求 commit 里面写细节。写 commit 了，那文档要不要写了

16

huang86041

10h 48m ago

现在的 commit 我都是 AI 帮我写,满足固定格式要求,然后能概括我改了什么.特别的项目,还可以把多个仓的提交文件汇总列出来. 不比写 1 要好.也不费时间.

17

chenyu0532

10h 43m ago

强制简写，但是不能写 "修复了一个错误" 等毫无价值的

18

swananan

10h 38m ago

很显然 commit message 不应该这么来用，commit 是用来补充代码无法提供的信息，业务背景上下文以及 trade off 。详细的实现细节或者架构，应该写成文档。

推荐个文章：How to Write a Git Commit Message
https://cbea.ms/git-commit/