如何在Conan软件包中定义组件？配置独立组件为何触发ConanException报错

这个异常是Conan对CppInfo配置的强制校验触发的拦截，对应的互斥规则非常明确：

• self.cpp_info 支持两种完全互斥的配置模式：全局单库模式、组件化模式
• 全局单库模式：所有编译、链接配置直接写在self.cpp_info顶层，不定义任何components字段
• 组件化模式：所有编译、链接配置全部下沉到各个独立component内部，全局层级的cpp_info不允许存在任何构建相关的属性值
  两种模式不能混用，只要检测到同时存在components定义和全局层级的非空构建属性，就会直接抛出这个异常。

很多人会有认知偏差："我只写了两行components的定义，根本没给全局cpp_info赋过值，怎么就成混用了？"
问题出在Conan的CppInfo默认初始化逻辑上：

• 当Conan实例化self.cpp_info对象时，为了兼容传统单库包的零配置场景，会自动在全局层级填充几个默认路径值：比如把包内的include目录加入全局includedirs、把lib目录加入全局libdirs、把bin目录加入全局bindirs
• 这些自动生成的默认值，哪怕你一行相关配置代码都没写，也是真实存在于全局cpp_info上的非空值
• 当你手动新增CA、CB两个组件时，校验逻辑会扫描全局CppInfo属性，发现上面已经有非空的构建类值，就会判定你违反了两种模式互斥的规则，直接抛错

这也是为什么很多人觉得自己严格照着文档写了两行组件定义，还是触发报错的核心原因——抄示例的时候只复制了组件定义的代码，没注意到组件模式对全局CppInfo的约束要求。

要切换到合法的组件化配置，需要完成两步调整：

• 把每个组件独立需要的编译、链接配置，全部下沉到对应component的属性上，比如每个组件的头文件目录、链接库文件路径
• 把Conan自动填充在全局CppInfo上的所有构建类属性全部置空，确保全局层级没有遗留的非空值

参考可运行的实现代码：

def package_info(self):
    # CA组件的独立配置
    self.cpp_info.components["CA"].libs = ["a"]
    self.cpp_info.components["CA"].includedirs = ["include/a"]  # 按包内实际的头文件路径填写
    
    # CB组件的独立配置
    self.cpp_info.components["CB"].libs = ["b"]
    self.cpp_info.components["CB"].includedirs = ["include/b"]
    
    # 清空全局层级被Conan自动填充的默认构建路径，解除混用违规
    self.cpp_info.includedirs = []
    self.cpp_info.libdirs = []
    self.cpp_info.bindirs = []

如果调整后仍触发同类报错，可以进一步扫描全局cpp_info上是否残留其他非空的构建类属性（比如defines、编译flags、链接选项等），只要存在非空值，都需要置空或者下沉到对应的component内部。

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