知识卡片

普通读书笔记卡 · 6991.r.2.e · 生成模型:未记录

警示应保留危险条件与理由

理解等级:中级

耗时极长的测试或有共享状态限制的工具,值得在相应入口说明代价、触发条件及为何采取特殊处理。测试被禁用时也应给可追溯原因,而不是让人误以为已经通过。注释只能提醒,是否执行、怎样隔离与检查仍由实际流程负责;方法下划线与@Ignore是书中不同年代的测试约定。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《代码整洁之道》全书 · 第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