《 测试反模式：有效规避常见的92种测试陷阱》——1.8 陷阱描述

本节书摘来自华章计算机《 测试反模式：有效规避常见的92种测试陷阱》一书中的第1章，第1.8节,作者：（美）　Donald G. Firesmith 更多章节内容可以访问云栖社区“华章计算机”公众号查看。

1.8　陷阱描述

第2章给出了对不同陷阱的概要的描述，而第3章记录了每个测试陷阱的详细信息，如下：

• 标题　该陷阱的简短、描述性名称
• 描述　该陷阱的简单定义
• 可能出现之处　陷阱可能出现的环境
• 典型症状　（或者，你怎么知道）表明可能存在的陷阱的症状
• 潜在的负面后果　（为何你要关心）如果不避免或减轻陷阱，预期潜在的负面后果[3]
• 潜在原因　陷阱潜在的根本原因和近因[4]
• 建议　（你应该做什么）建议采取的行动（准备、启用、执行和验证）来避免或减轻陷阱[5]
• 相关的陷阱　其他相关测试陷阱列表
  在开始阅读单个陷阱之前，这里有关于选词和语法的几句话：
• 可能出现之处　你可能在你的项目中落入这些陷阱，也可能不会。有些陷阱更可能出现，因此，这些陷阱比其他陷阱更相关。当然，如果你已经掉进一个既定的陷阱，它就不再是可能出现的，而是一定会出现。因为目前存在可能出现之处，将用现在时进行描述。
• 典型症状　你可能已经在过去观察到这些症状，你很可能现在正在观察它们。它们甚至有可能在未来等着你。不必写出所有三种时态拯救了我，更重要的是，不必阅读它们也拯救了你，我用现在时列出了所有的症状。
• 潜在的负面后果　再次，你可能已经在过去遭受过这些后果，也可能正在发生。这些后果可能仍然在未来出现，如果你现在遵循合适的建议则可避免（或减缓）。这些后果用现在时列出。
  请注意，有时一个陷阱的第一症状是因为你陷入而遭受的负面后果。因此，是否应该列入症状、后果或两者并不总是显而易见。为了避免将同一负面事件或情况在同一个陷阱里列出两次，我尽力在最明显的标题下包含一次。
• 潜在原因　最后，原因也可能在你的过去、现在或将来。然而，它们似乎最好用过去时态写，因为从本质上，它们必须先于陷阱的症状和后果。