rust - rustdoc no_main “crate-level attribute should be in the root module”

Question

在Rust中使用 no_main 外部属性时， cargo doc 提示unused attribute和crate-level attribute should be in the root module。

我每晚使用Cargo 1.42.0。

相关代码:

// main.rs

#![no_main]

这仅在调用 cargo doc时发生； cargo build可以正常工作。

我看过 https://github.com/rust-lang/rust/issues/62184，但是不包含任何答案。
我还看到了 https://github.com/rust-lang/rust/issues/43144，从那里开始是 https://github.com/rust-lang/rust/pull/64471，但是即使该合并请求已经被合并，问题仍然存在。

如何解决此警告？

Answer 1

此警告是由known bug in cargo/rustdoc引起的，但尚未修复。

到目前为止，可以通过以下方式将 cfg_attr attribute与rustdoc的 cfg(doc) 结合使用，轻松解决此问题:

// main.rs

#![cfg_attr(not(doc), no_main)]

此代码在所有情况下都适用 no_main属性，除非正在构建文档。