Doctests

文档中提供的示例可以转换为测试并包含在测试运行中。该做法称为文档测试。这有助于保持文档与代码同步。您可以在 rustdoc book中了解有关 doctest 的更多信息。

运行 doctest

RustRover 会自动检测 doctest。您可以使用以下描述的方法来运行它们。

此外，由于 doctest 被归类为测试，因此会包含在测试运行中。如需了解启动测试的方法，请参阅运行测试页面。

要运行特定测试，请点击 doctest 条目旁的装订区域中的：
要运行模块或项目中的所有 doctest，请打开 Cargo 运行任意内容弹出窗口（按两次 Ctrl ），并在需要时指定附加参数的 cargo test --doc 命令。

使用上述方法之一运行 doctest 时，IDE 会自动创建配置并将其保存以供日后使用。要修改当前配置，请点击三点图标，选择修改运行配置，并在编辑运行配置对话框中进行调整。

您也可以手动创建 doctest 配置：请按照创建测试配置的步骤进行操作，并在需要时指定附加参数的 cargo test --doc 命令。

Doctest 结果将显示在运行工具窗口中，与常规测试结果一起展示。如需详细了解测试结果的操作方式，请参阅探索测试结果页面。

2026年 3月 25日