知识卡片
说明意图不等于证明方案正确
注释能交代“为何这么做”,例如为何把本类型排在其他类型之后,或为何启动大量线程尝试撞出竞争。但知道作者目的,还需要检查比较契约、测试等待和失败条件是否成立。说明不是把错误设计变正确的凭据;保留理由能帮助后来者评价与替换它,而不是阻止质疑。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第4章 注释
原书出处 · 1 处
- 第4章 注释 4.3 好注释 · 查看原书依据
至少你知道他想干什么
参考来源
- 位置:《代码整洁之道》全书 · 第4章 注释,spine013单元002;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0011.xhtml。
- 结论依据:原文明确允许不同意解决方案但仍理解意图,直接支持意图解释与方案验证分开,示例本身未提供完整正确性证据。未在本机运行示例或改变环境。
- 原始内容:不同意程序员给这个问题提供的解决方案,但至少你知道他想干什么。 public void testConcurrentAddWidgets() throws Exception { WidgetBuilder widgetBuild