Doctests

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

运行 doctest

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

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

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

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

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

Doctest 结果会显示在运行工具窗口中，与常规测试结果一起展示。有关操作测试结果的详细信息，请参阅浏览测试结果页面。

最后修改日期： 2025年 12月 5日