Active voice vs. passive voice

技术文档写作中，大部分句子都应该使用主动语态。通过该单元的学习，你将会掌握：

• 如何区分主动语态和被动语态 （译注：译者假设你有一定英文基础，这部分内容略过）。
• 将被动语态改成主动语态，使句子清晰。

优先使用主动语态

写作中，大部分时间应该使用主动语态。被动语态仅在极少数的情况下使用。使用主动语态有如下好处：

• 大部分读者阅读时，都会在脑里将被动语态转成为主动语态。为什么还要让你的读者额外的时间作这个转换？坚持使用主动语态，读者可以跳过”预编译“阶段，直接进入”编译“阶段。
• 被动语态将句子颠倒过来，会混淆你的想法，让句子模糊不清。而且被动语态只能间接地表达句子里的动作。
• 有些被动语句完全省略了主语，强迫读者去猜测主语。
• 主动语句一般短于被动语句。

勇敢点，使用主动语态吧！

科研报告 (可选)

被动语态在一些可研报告中有点过于泛滥了。在这些报告中，实验者和实验器械通常消失了，变成如下样子的被动语句：

• It has been suggested that...
• Data was taken...
• Statistics were calculated...
• Results were evaluated.

从这些句子中可以看出主语和宾语吗？不能。被动语态有让句子变得更加客观吗？没有。

许多科学期刊都采用了主动语态，我们建议其他期刊也加入这个行列。

练习

重写句子，将下列被动语句写成主动语句。

1. The flags weren't parsed by the Mungifier.
2. A wrapper is generated by the Op registration process.
3. Only one experiment per layer is selected by the Frombus system.
4. Quality metrics are identified by asterisks; ampersands identify bad metrics.

Reference

原文：https://developers.google.com/tech-writing/one/active-voice