conan 2.x 中不能在 default_options 中设置依赖包选项,须通过 requires() 显式传参或 configure() 动态覆盖;选项名须与被依赖包 options 字典严格一致,且仅在其声明后生效。

Conan 2.x 中不能在 default_options 里直接设置依赖包的选项 —— 那些选项属于被依赖的包,不是当前包自己的。 你看到的“默认覆盖”现象,本质是 Conan 在解析依赖图时,把上游包(比如 A)的 default_options 和下游包(比如 B)传入的选项混在一起做了合并,而后者优先级更高。所以真想控制依赖的编译行为,得在正确的位置、用正确的方式传参。
conanfile.py 中用 requires() 显式传递选项
这是最直接、最可控的方式,适用于你知道依赖包有哪些可配置选项,并希望在当前项目中固定它们的值。
-
requires()支持带选项字符串的语法:self.requires("zlib/1.2.13", options={"shared": True, "fPIC": True}) - 选项名必须和被依赖包的
options字典定义完全一致(大小写、下划线都不能错) - 如果依赖包本身没声明该选项(比如误写
"shard"),Conan 不会报错,但也不会生效 —— 最终还是走它自己的default_options - 多个依赖可分别传:比如
self.requires("fmt/10.2.1", options={"header_only": True})和self.requires("spdlog/1.13.0", options={"shared": False})
configure() 方法里条件性覆盖依赖选项
当你的选项逻辑较复杂(比如“仅在 Windows 上让 OpenSSL 启用 no_asm”,或“Debug 构建时强制所有依赖用 shared=False”),就不能硬编码在 requires() 里,得移到 configure() 中动态处理。
-
configure()在依赖图解析后、构建前调用,此时self.dependencies已可用 - 修改方式是操作
self.dependencies["zlib"].options.shared = True,注意不是赋值给self.options - 必须确保目标依赖已存在,否则会抛
KeyError;建议先用if "zlib" in self.dependencies:判断 - 这个修改只影响当前 conan install 这一次的依赖解析,不会改变远程包本身的默认值
避免用 profile 或命令行全局覆盖,除非你真需要统一策略
通过 conan install . -o zlib:shared=True 或在 profile 文件里写 zlib:shared=True 确实能生效,但它作用于整个依赖树,且容易被其他地方的更细粒度设置覆盖(比如 requires() 中的显式选项)。
- profile 方式适合 CI 场景下统一管控(如所有项目在 ARM64 上都禁用 shared 库)
- 命令行
-o适合调试临时切换,不适合写进自动化脚本 —— 容易遗漏或拼错包名 - 特别注意:profile 里的
zlib:shared写法必须和包名完全一致,zlib/1.2.13:shared是无效的 - Conan 2.x 不再支持旧版的
[options]section in conanfile.txt 来设依赖选项 —— 那个位置只接受当前项目的选项
最容易被忽略的一点:**依赖包自己的 default_options 是在它的 conanfile.py 里定义的,你无法绕过它直接“重置”为 unset 状态。** 所有外部传入的选项,都是在它的默认值基础上做覆盖。如果你发现某个选项始终不生效,先检查它是否真的在被依赖包的 options 字典里声明了 —— 很多包只对关键路径提供选项,其余全靠内部逻辑推导。











