知识卡片
警示应保留危险条件与理由
耗时极长的测试或有共享状态限制的工具,值得在相应入口说明代价、触发条件及为何采取特殊处理。测试被禁用时也应给可追溯原因,而不是让人误以为已经通过。注释只能提醒,是否执行、怎样隔离与检查仍由实际流程负责;方法下划线与@Ignore是书中不同年代的测试约定。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第4章 注释
原书出处 · 1 处
- 第4章 注释 4.3.4 阐释 · 查看原书依据
警告其他程序员会出现某种后果
参考来源
- 位置:《代码整洁之道》全书 · 第4章 注释,spine013单元003;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0011.xhtml。
- 结论依据:原文以大文件测试禁用和线程不安全提示说明后果警示,支持原因与条件可见,不把跳过当成功或旧发现规则当当前全部接口。未在本机运行示例或改变环境。
- 原始内容:正确性。 4.3.5 警示 有时,用于警告其他程序员会出现某种后果的注释也是有用的。例如,下面的注释解释了为什么要关闭某个特定的测试用例: // Don't run unless you // have some time to kil