技术英语 / 系统课时

区分事实陈述与主观判断

区分事实陈述与主观判断

开源讨论中的误解,很多并不是语法错误,而是把推测写成了事实、把个人观察写成了普遍结论。把事实、观察、推测和建议分开表达,可以让别人准确判断证据强度,也更容易继续定位问题。

学习目标

  • 区分可验证事实、个人观察、推测和建议
  • 使用合适的英语措辞表达不同确定程度
  • 避免把有限证据写成武断结论

四类表达解决不同问题

事实、观察、推测和建议可以出现在同一条 Issue 回复中,但它们承担的作用不同。

类型 核心问题 示例
可验证事实 有什么可以被他人检查的结果 The test fails on Node.js 22.
个人观察 我在自己的条件下看到了什么 I can reproduce this on macOS 15.
推测 可能是什么原因 This may be related to the new cache logic.
建议 接下来可以做什么 I suggest adding a regression test first.

事实通常需要版本、日志、测试结果或代码行为作为支撑。观察强调证据来自你的环境,不保证所有人都会得到相同结果。推测必须保留不确定性,而建议表达的是行动方案,不应伪装成已经证明的结论。

给句子标出证据强度

假设某个 PR 合并后测试开始失败。直接写 This change breaks the build. 很强,因为它声明已经确认“这个修改导致构建失败”。如果目前只知道自己本地失败,这个结论可能超过已有证据。

更准确的写法是:The build fails on my machine after applying this change. 这是一条观察,其中明确限定了环境和发生条件。

如果你进一步怀疑缓存代码造成问题,可以写:This may be related to the cache invalidation change, but I haven't confirmed it yet. 这里把推测和确认状态同时说清楚,其他维护者不会把它误读成已经定位的根因。

把混在一起的话拆开

实际讨论经常把观察、原因判断和建议塞进一句话,例如:The parser is broken, so we should revert this PR. 这句话同时断言了解析器已经“坏了”、默认当前 PR 是原因,并直接给出回滚方案,读者很难知道哪些部分已经被验证。

可以拆成三层:I can reproduce the parsing failure with the sample below. The regression appears after this PR, but I haven't isolated the exact cause yet. I suggest checking the parser changes before deciding whether to revert.

拆开之后,信息边界十分清楚:第一句是可复现观察,第二句是带限制条件的推测,第三句才是建议。即使最终证明判断错误,前面的客观信息仍然有价值。

避免把局部经验扩大成普遍结论

英语能力有限时,人们容易依赖 always、never、obviously、definitely 这类短而直接的词,但这些词会显著提高结论强度。

如果你只测试了一个版本,不要写 This always fails on Windows. 可以写 I can reproduce this on Windows 11 with version 3.2. 如果只读了部分代码,不要写 This is obviously caused by the retry logic. 可以写 The retry logic looks like a possible cause; I haven't verified it yet.

类似地,This implementation is wrong. 把评价直接指向结论,却没有说明判断依据。更有效的表达是:This implementation returns an empty value when the key is missing, while the documented behavior is to return null. 先给出可验证差异,再讨论是否需要修改。

用事实推动下一步讨论

一条高质量回复通常不需要复杂英语。可以先写环境和现象,再说明自己的判断强度,最后提出下一步动作。例如:I can reproduce the failure on Python 3.13. It seems to happen only when the cache is enabled. I haven't confirmed the root cause yet. Could we add a test for this case before changing the implementation?

这种表达不会因为谨慎而失去效率。相反,其他参与者可以迅速知道哪些信息已经确认、哪些仍需验证、接下来可以做什么。开源协作里真正需要避免的不是主观判断本身,而是让读者无法分辨判断和事实之间的边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分事实陈述与主观判断

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通