6.2.2.2 文档与约定规范

文档摘要

6.2.2.2 文档与约定规范 6.2.2.2 文档与约定规范：当注释开始“撒谎”——用 + 构建可验证的契约式注释体系你有没有在凌晨两点调试一个看似无害的方法时，突然发现它的 Javadoc 里写着：“返回值为正整数，永不为零”，而实际运行中它却在会员等级为且订单满减券已过期时，悄悄返回了？你有没有在 Code Review 中看到同事提交的 PR，其中一段被精心包裹在里的说明文字，读起来逻辑严密、措辞精准，甚至引用了 RFC 文档编号——可当你点进方法体，却发现它调用了三个未文档化的私有工具类，其中一个还在 catch 块里吞掉了，还顺手把异常堆栈写进了日志文件的第 7 行第 42 列？