技术人员通常不爱写文档或者不愿意在文档上花时间，导致前后端各开发各的，没有规范标准，如需和外部系统对接时，又得捋一遍代码找接口参数。接口文档能节约联调沟通时间和减少bug引入，提高代码质量。

3.地坑：不考虑拓展功能

代码不解解耦，不考虑未来可能会拓展的设计，无疑是在给队友挖坑。

小袁接手一个烂尾项目，上线后需要初始化数据，怎么也找不到批量处理接口。打电话问已离职的前同事，“什么？你当时只写了跑单个数据的接口，没写批量的？”

除了上面几个坑外，还有底下的挖坑指南：

不实时容错，程序只按照自己脑子“理所当然”的轨迹运行；

• 许勤会见德国勃兰登堡州州长沃伊德克一行
• 马云上课：我最后还是会回到老师这一行
• 滴滴CEO程维：确实丧失了足够的敬畏之心、安全红线和底线意识
• 英国皇家工程院院士李琳教授一行高度评价森赫电梯，或将联合研发
• 再见铁饭碗！又一行业被颠覆！中国建设银行正式宣布......
• 程序员变成“袭胸摸臀”狂魔 他胆子为什么越来越大
• 南宁警方开展社会治安综合整治统一行动
• 李彦宏放大招！刚拿下基金销售牌照,用人工智能改造这一行！互联
• 杨父一行到达法院 杨家：相信会公正判决
• 陈刚会见华为董事长梁华一行