为什么开发人员都不愿意写接口文档？

[jessezhang1986]

[66450146]

把接口调得能通过机器检查容易

想清楚系统的结构和逻辑并清晰地表达出来很难

写文档就是后者

[JerryCha]

应付需求已经很累了，还写文档那是连午睡都搭进去了

[knightdf]

可能上级定任务时间的时候压根就没考虑你写文档的时间

[tianxia]

因为自己觉得还有变动

[echo1937]

老板没给这个时间

[foxtalk]

大公司应该好一点，小公司的领导们，大多不注重代码规范，接口设计，只是抱着能用就行的思维，没有留出足够的时间让你好好设计接口和文档，在他们眼里，项目的进度重要程度是远远大于代码质量和设计文档的。大公司里面有代码审核人员，会好很多。

[Euthpic]

@apifox 考虑下 yapi

[kingfalse]

因为写文档不算工作量

[sytnishizuiai]

前后分离，不写文档，前端怎么开发啊？哪知道传什么，返回什么。

不过文档确实累心，开发的时候忙的要死，还要写文档，开发完了又是一堆事，我是没办法，前后端都在家办公，全靠文档开发。

还有一部分原因在于领导，很多人认为代码跑起来就项目结束，再搞一个。剩下的代码优化，文档写完整，sql 优化也懒的搞了，没精力。

[so1n]

写文档很累。。。所以我就自己写了一个框架来自动生成文档 https://github.com/so1n/pait

[icy37785]

自己的项目最烦写文档，别人的项目最烦没文档。
可能这就是社会主义初级阶段的主要矛盾把。

[wolong]

因为不会写

[skys215]

因为程序员只会写代码，不会写人话。

[Kontinue]

新项目和前端对接或者需要第三方对接的时候会写。但是后面需求改动的时候就懒得再改文档了。。。

[ada87]

标题说了，主要就是因为不愿意。

早上 9 点上班，激情满满的码代码，可以一口激情码到下班。
要是写一小时接口文档，写到 10 点，一整天的心情都不好了，特别是本来就还有干不完的活的情况下（借口），码代码的心情也没了，写代码心情差，效率质量齐下降。

[Kontinue]

其实都是相对的，和别人对接，不写文档，自然很多细节的地方别人都会来问你，还不如一次性都写清楚

[jorneyr]

自己不写有合理的理由，但常常抱怨别人不写。

[From313]

YAPI + 1

[niub]

写。

[andytao]

因为代码即文档，代码是最新最完整的文档呀。