技术英语 / 系统课时

区分 must、should 和 may

区分 must、should 和 may

技术文档里的 must、should 和 may 不是语气强弱的随意选择,而是在告诉读者某个动作究竟是硬性要求、推荐做法还是可选行为。本篇通过常见配置与接口说明场景,建立一套稳定的选词标准,让要求既准确又不会被读者误解。

学习目标

  • 根据约束强度正确选择 must、should 和 may
  • 区分 must not、should not 与 may not 所表达的不同含义
  • 把含糊的中文要求改写成可以直接执行的英文规则

先判断读者有没有选择权

选择情态动词时,先不要翻译中文里的“必须、应该、可以”,而要问一个更具体的问题:如果读者不这样做,系统是否仍然符合要求?

表达 文档中的典型含义 读者是否有选择权
must 硬性要求,不满足就违反规则或无法正常工作 没有
should 强烈建议,通常应遵循,但存在合理例外 有,但需要理由
may 允许或可选,不要求一定执行 有

例如,认证令牌缺失就会导致请求无效,可以写:

The request must include an authentication token.

如果开启缓存只是性能建议,而不是正确性要求,更适合写:

You should enable caching for frequently accessed data.

如果某项功能完全由使用者决定,可以写:

You may specify a custom timeout.

关键不是哪一个词“听起来更正式”,而是它是否准确表达违反该规则后的后果。

must 用于不可违反的约束

must 适合协议要求、安全限制、数据格式、前置条件以及系统无法自动补救的规则。使用它时,应确保文档确实存在明确后果,否则会把普通建议错误包装成强制要求。

例如:

File names must be unique within the project.

这句话表示重复文件名是不被允许的。若真实情况只是“唯一名称更方便维护”,就不应该使用 must。

否定形式 must not 表示明确禁止:

Clients must not send credentials over an unencrypted connection.

它不是“最好不要”,而是规则本身不允许这样做。涉及安全、兼容性或协议边界时,这种区别尤其重要。

should 表达默认建议而不是命令

should 用于通常正确、值得推荐,但在特殊情况下可以偏离的做法。它常见于性能建议、工程惯例、默认配置以及兼容性指导。

You should reuse the existing connection when possible.

这里允许调用方在连接失效、隔离要求或其他合理条件下创建新连接。如果实际上创建新连接会直接导致错误,就应改成 must。

should not 同样表示强烈不建议,而不是绝对禁止:

You should not store generated files in the source directory.

如果项目工具确实允许这样做,只是会增加维护成本,那么 should not 比 must not 更准确。

may 用于权限和可选行为

may 表示某个动作被允许,或者某个能力是可选的。它尤其适合描述可选参数、扩展行为和实现自由度。

The client may retry the request after a timeout.

这句话没有要求客户端必须重试,只说明重试是允许的。

需要特别注意 may not 的歧义。在日常英语中,它既可能被理解为“不允许”,也可能被理解为“可能不会”。技术文档如果要表达禁止,优先写 must not;如果要表达可能不会发生,改写成更明确的形式,例如:

The response might not include this field.

这样可以避免读者把概率判断误认为规范限制。

从中文要求推导英文表达

中文里的“需要”“最好”“可以”经常依赖上下文,因此不应逐词替换。改写时可以按后果判断:

  1. 不执行就会报错、违规或破坏兼容性,使用 must。
  2. 不执行仍能工作,但通常不是推荐方案,使用 should。
  3. 是否执行都符合要求,使用 may。

例如“客户端需要保存请求 ID”只有在请求 ID 是后续操作的必要条件时才应写成 must。如果它只是为了方便排查日志,应改成 should。若保存与否完全由调用方决定,则应使用 may。

同一篇文档中保持这种语义稳定,比单纯追求正式语气更重要。读者看到 must 时应知道这是不可省略的要求,看到 should 时知道存在合理例外,看到 may 时则清楚这是自己的选择。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分 must、should 和 may

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

登录哪都通