技术英语 / 系统课时
用简洁英语解释设计取舍
用简洁英语解释设计取舍
技术设计说明的难点不是把方案写得“高级”,而是让团队看懂为什么选择它。本篇用约束、备选方案、收益和代价组织英文论证,并把 fast、simple、scalable 等空泛形容词替换成可验证事实,使设计讨论和 ADR 中的结论更容易评审。
学习目标
- 用 constraint、alternative、benefit、trade-off 等概念组织设计说明
- 用可测量或可观察的事实替代 vague 的技术形容词
- 写出同时说明选择理由和代价的简洁英文结论
从约束开始而不是从方案开始
设计说明如果直接写 We chose Redis because it is fast.,读者只能看到结论,看不到判断标准。更有效的顺序是先交代约束,再说明什么方案满足它。
例如:The service must return cached results within 20 ms at the 99th percentile. The cache can be rebuilt from the database, so losing cached data is acceptable.
这两句给出了两个关键约束:延迟目标和数据可丢失性。后面选择内存缓存、Redis 或其他方案时,团队已经知道应该用什么标准评估,而不是围绕个人偏好争论。
常用的约束表达包括 must support、must remain below、cannot depend on、is limited to 和 is acceptable。其中 must 应留给真正不可违反的要求,不要把所有偏好都升级成硬性条件。
比较真正可行的备选方案
说明取舍时至少需要一个合理的 alternative,否则 We chose X 很容易变成没有论证的决定。比较时应让各方案回答同一组问题。
例如:We considered storing sessions in PostgreSQL and Redis. PostgreSQL avoids an additional service, but session reads would share database capacity with transactional queries. Redis adds operational overhead, but isolates session traffic and provides built-in expiration.
这段没有把一个方案写成“好”、另一个写成“差”,而是分别指出收益和成本。这样的英文更适合评审,因为团队可以继续验证容量、运维复杂度和故障模式,而不是争论形容词。
用事实替换空泛形容词
fast、simple、flexible、scalable、better 经常出现在技术讨论中,但单独使用时很难验证。改写时可以追问:具体改善了什么指标、减少了什么步骤,或者支持了什么边界?
| 空泛表达 | 更可验证的表达 |
|---|---|
This is faster. |
This reduces the median query time from 120 ms to 45 ms in our benchmark. |
This is simpler. |
This removes one deployment unit and two configuration files. |
This scales better. |
Workers can be added independently without repartitioning existing jobs. |
This is more reliable. |
A worker failure no longer interrupts requests handled by other workers. |
如果还没有测量数据,不要制造数字。可以诚实地写出可观察的机制,例如 This avoids an extra network request on every cache hit.,并把尚未验证的结果标成假设:We expect this to reduce request latency, but we have not benchmarked it yet.
把收益和代价写在同一个结论里
成熟的设计决定很少只有收益。We chose X because it is better. 会隐藏维护成本、性能损失或适用边界。更清楚的句型是:We chose X because ..., at the cost of ...。
例如:We chose asynchronous replication because the write path must remain available during replica latency, at the cost of a small window in which recently written data may be lost.
也可以使用 This improves ..., but ... 或 The main benefit is ..., while the main drawback is ...。这些表达不会削弱结论,反而让读者知道团队已经识别并接受了什么风险。
写成一段可评审的设计决定
一段简洁 ADR 可以按“约束 → 备选方案 → 决定 → 代价”组织:
The API must handle temporary traffic spikes without increasing database connections above 200. We considered direct database access and a bounded worker queue. Direct access has lower application complexity, but each concurrent request can consume a connection. We chose the bounded queue because it caps concurrent database work at 150 requests. The trade-off is that excess requests may wait longer or be rejected when the queue is full.
这段文字没有依赖复杂词汇,却回答了评审最关心的问题:限制是什么、考虑过什么、为什么这样选,以及选择后必须接受什么。写设计英语时,优先让这些关系可追踪,比追求正式或华丽的表达更重要。