Cargo是否会统一[build-dependencies]与[dependencies]的features？

核心机制说明（基于resolver = "2"） #

Cargo resolver 2的设计目标之一是减少重复编译开销，默认情况下，只要依赖的版本号一致，[build-dependencies]和[dependencies]中的同一个crate会共享编译实例——哪怕两者启用的feature不同。

你遇到的情况正是如此：虽然你在[build-dependencies]中给Y开了特定feature，主依赖里没开，但Cargo认为这是同一个版本的Y，所以直接复用了已经编译好的带feature的版本，没有重新编译无feature的版本。

关于你看到的官方文档描述：

包本身与其构建脚本是分开构建的，因此它们的依赖不必一致。
这句话的意思是允许两者依赖不同版本的同一个crate，或者不同的feature组合，但Cargo会优先复用能兼容的已编译产物，只有当依赖配置（feature、版本、目标平台等）存在无法调和的冲突时，才会编译多个独立实例。

解决方法 #

要让Cargo为构建脚本和主代码分别编译Y的不同feature版本，需要明确隔离两者的依赖实例，有两种可行方式：

1. 使用package别名强制区分

在Cargo.toml中给Y设置不同的别名，让Cargo将它们视为两个独立依赖：

[dependencies]
y_main = { package = "y", version = "x.y.z", default-features = false }

[build-dependencies]
y_build = { package = "y", version = "x.y.z", features = ["your_feature"], default-features = false }

之后在主代码中用use y_main as y;，构建脚本中用use y_build as y;来统一调用。

2. 配置resolver的features隔离（Cargo 1.60+）

在[package]下添加resolver的features配置，明确指定主依赖和build依赖的Y使用不同的feature集：

[package]
name = "x"
edition = "2021"
resolver = "2"

[dependencies]
y = { version = "x.y.z", default-features = false }

[build-dependencies]
y = { version = "x.y.z", features = ["your_feature"], default-features = false }

[resolver]
features = {
    build-dependencies = { y = ["your_feature"] },
    dependencies = { y = [] }
}

这种方式不需要修改代码中的use语句，更简洁，但要求Cargo版本在1.60及以上。

内容的提问来源于stack exchange，提问作者big_gie