conan通过settings(如os、arch、compiler、build_type)自动区分架构并生成唯一package id,无需手动切包名或路径;但必须在profile和conan install命令中明确指定目标arch,否则可能拉错二进制导致链接失败或segfault。

Conan 默认按 settings 自动区分架构,不用手动切包名或路径,但必须确保 profile 和 conan install 命令中明确指定目标架构
profile 里没设 arch 就会用默认值,导致跨平台构建失败
Conan 的 settings(如 os、arch、compiler、build_type)共同决定一个包的 package_id。只要 arch 不同,哪怕其他设置全一样,也会生成完全独立的二进制包。
常见错误是直接运行 conan install . 而不指定 profile,此时 Conan 会用 ~/.conan2/profiles/default —— 它可能被 conan profile detect 设为 x86_64,但你实际想构建 aarch64 或 armv7 的包,结果拉错二进制、链接失败、甚至静默运行却 segfault。
- 检查当前 profile:运行
conan profile show default,确认arch字段是否符合预期 - 为不同架构创建专用 profile:
conan profile new linux_aarch64 --detect && conan profile update settings.arch=aarch64 linux_aarch64 - 交叉编译时,profile 必须同时声明
settings.os_build和settings.os_host(Conan 2.x 要求),否则package_id计算异常
conanfile.py 中的 settings 声明决定包能支持哪些架构
如果你在写自己的 conanfile.py(比如打包一个自研库),settings 字段不是可选提示,而是硬性约束:它定义了这个 recipe 允许被构建的所有维度组合。漏写 arch,Conan 会拒绝安装任何带 arch 的 profile,报错 Setting 'arch' is not defined。
示例正确声明:
from conan import ConanFile
<p>class MyLib(ConanFile):
name = "mylib"
version = "1.0"</p><h1>必须显式列出所有要支持的 setting 维度</h1><pre class="brush:php;toolbar:false;">settings = "os", "arch", "compiler", "build_type"
# 如果只支持特定 arch,可在 validate() 中拦截
def validate(self):
if self.settings.arch not in ["x86_64", "aarch64", "armv7"]:
raise ConanInvalidConfiguration(f"Unsupported architecture: {self.settings.arch}")
- 不写
arch在settings里 → recipe 根本无法用于多架构场景 - 写了但没在
validate()里限制 → Conan 仍会尝试构建,可能因源码不兼容而编译失败 -
arch值必须是 Conan 内置枚举(如x86_64、aarch64、armv7),不能写成arm64或ARM,否则 profile 加载失败
同一个 recipe 在不同架构下生成的包,ID 完全隔离,不会互相覆盖
Conan 用 package_id() 方法把 settings 哈希成唯一 ID。这意味着:
-
mylib/1.0@user/stable在arch=x86_64下生成的包,和arch=aarch64下生成的包,存储路径完全不同(~/.conan2/p/mylib/1.0/_/_/package/<hash></hash>) - 执行
conan install . -pr:h linux_aarch64 -pr:b default(host 为 aarch64,build 为本地 x86_64)时,Conan 会自动识别并拉取对应 host 架构的二进制,不会误用 build 架构的包 - 如果某架构没有预编译包(比如 ConanCenter 没提供
armv7的openssl),--build=missing会触发本地交叉编译 —— 前提是你的 profile 和 toolchain 支持
最容易被忽略的是:profile 中的 arch 必须与你最终部署的目标设备严格一致,包括大小写和命名规范;差一个字符,Conan 就当它是全新架构,既不复用缓存,也不报明显错误,而是默默构建一个无法运行的包。











