Rust Blog
·
docs.rs：默认构建更少的目标
内容提要
从2026年5月1日起，docs.rs将仅为默认目标构建文档，除非用户明确请求其他目标。这一变化旨在提高构建效率，减少资源消耗。用户可以在Cargo.toml中设置targets来指定需要构建的目标。
关键要点
-
从2026年5月1日起，docs.rs将仅为默认目标构建文档，除非用户明确请求其他目标。
-
这一变化旨在提高构建效率，减少资源消耗。
-
用户可以在Cargo.toml中设置targets来指定需要构建的目标。
-
如果未设置default-target，docs.rs将使用其构建服务器的目标：x86_64-unknown-linux-gnu。
-
docs.rs仍然支持Rust工具链中可用的任何目标，只有默认行为发生变化。
延伸解读
构建效率的提升
docs.rs的这一变化旨在提高构建效率，减少不必要的资源消耗。大多数crate并不为不同目标编译不同的代码，因此默认只构建一个目标可以更好地适应大多数发布需求。
用户自定义设置
用户可以通过在Cargo.toml中设置targets来指定需要构建的目标。如果需要构建多个目标，务必明确列出所有目标，以确保文档的完整性和可用性。
默认目标的影响
如果用户未设置default-target，docs.rs将使用其构建服务器的默认目标x86_64-unknown-linux-gnu。这意味着在未做任何设置的情况下，用户的文档将仅针对这一平台构建。
延伸问答
docs.rs的默认构建行为有什么变化？
从2026年5月1日起，docs.rs将仅为默认目标构建文档，除非用户明确请求其他目标。
为什么docs.rs要减少构建目标？
这一变化旨在提高构建效率，减少资源消耗。
如何在Cargo.toml中设置构建目标？
用户可以在Cargo.toml中设置targets来指定需要构建的目标。
如果不设置default-target，docs.rs使用什么目标？
如果未设置default-target，docs.rs将使用其构建服务器的目标：x86_64-unknown-linux-gnu。
docs.rs是否支持其他Rust工具链中的目标？
docs.rs仍然支持Rust工具链中可用的任何目标，只有默认行为发生变化。
如何覆盖docs.rs的默认构建目标？
可以通过在docs.rs元数据中设置default-target来覆盖默认构建目标。
