技术英语 / 系统课时
不确定时明确假设与证据
不确定时明确假设与证据
开源讨论里很多信息在早期都无法完全确认。真正危险的不是存在不确定性,而是把推测写成事实。把已确认事实、当前假设和尚未验证部分明确分开,可以让维护者准确评估风险,也方便后续证据出现时更新结论。
学习目标
- 能区分已确认事实、合理推测和未知信息
- 能根据证据强度选择合适的英语措辞表达置信程度
- 能同时说明假设依据、验证状态以及下一步验证方式
把事实、推测和未知拆开
讨论问题时,先判断自己掌握的信息属于哪一层。已经通过复现、测试或源码确认的内容,可以直接陈述;由现象推导出的原因属于假设;缺少证据的部分则应明确保持未知。
例如你已经观察到关闭缓存后问题消失,这只是一个事实。它支持「问题可能与缓存有关」,但并不能自动证明「缓存实现就是根因」。更稳妥的表达是:
Disabling the cache makes the issue disappear. My current hypothesis is that stale cached data is involved, but I haven't confirmed the exact invalidation path yet.
这段话把观察结果、推测和未完成的验证分别说清楚。维护者可以沿着你的证据继续分析,而不会误以为根因已经确认。
根据证据强度选择措辞
当证据充分并已经验证,可以使用明确表达,例如 confirmed、reproduces consistently 或 the failure is caused by。这类措辞意味着你有能力说明验证方式,因此不要轻易使用。
证据较强但还没有完全排除其他原因时,可以使用 likely、appears to 或 seems to。例如:
This appears to be a regression introduced after v2.4.0. I can reproduce it on v2.5.0 and v2.6.0, but not on v2.4.0.
只有有限迹象时,应进一步降低确定程度,使用 might、may、possibly 或直接写 one possibility is。关键不是挑一个听起来委婉的词,而是让语言强度与证据强度一致。
把假设和依据写在一起
单独写「I think this is a race condition」信息量很低,因为维护者不知道你为什么这么判断。更有效的写法是同时给出假设、依据和验证状态。
My current hypothesis is a race condition because the failure only appears under concurrent requests. I haven't reproduced it with a single worker yet.
这种结构可以直接回答三个问题:你目前认为原因是什么,依据是什么,还有什么没有确认。
如果已经准备下一步验证,也可以再补一句具体行动:
I'll add logging around the shared state and check whether two requests update it at the same time.
这样讨论不会停留在「我觉得可能是」的阶段,而是能够继续积累证据。
新证据出现后及时更新结论
假设不是承诺。后续实验推翻原来的判断时,应直接更新,不需要为旧推测辩护。
My earlier assumption about the cache was incorrect. After testing without the cache layer, the failure still occurs. The common factor now appears to be the request ordering.
这种写法同时保留了讨论历史和最新结论,让后来阅读 Issue 的人能够理解判断是如何变化的。开源协作更看重结论能否随证据更新,而不是最初猜测是否一次命中。
哪些情况下必须保留不确定性
当问题只在特定操作系统、偶发并发、用户环境或无法完整复现的条件下出现时,应特别避免过早使用确定语气。日志缺失、样本过少、依赖版本不明或只能通过间接现象推断根因时,也应明确说明限制。
一个可靠的回复不需要消灭所有不确定性,而是让读者知道哪些已经确认、哪些只是当前最合理的解释、哪些仍待验证。只要这三层边界清楚,即使暂时没有最终答案,讨论仍然可以安全而高效地继续推进。