是,但取决于--build参数值和缓存状态:--build=missing仅缺二进制时构建,--build=outdated在id不匹配时构建,--build=always强制每次构建;conan create默认跳过build若id匹配,可用export-pkg绕过build直接打包已有文件。

conan install --build=xxx 会触发重编译吗
会,但不是无条件重编译。关键看 --build 参数的值和当前缓存状态。
常见用法有三种:
-
--build=missing:仅当远程没有匹配二进制(ID 完全一致)时才构建,已有缓存就跳过 -
--build=outdated:当本地缓存的二进制 ID 与当前依赖树计算出的 ID 不一致时才构建(比如改了compiler.version或某个option) -
--build=always:强制跳过所有缓存,每次都从源码重新 build,无论 ID 是否匹配
注意:--build=always 不等于“强制重生成包”,它只控制构建阶段;最终是否写入缓存、是否覆盖旧包,还取决于后续是否调用 conan export-pkg 或 conan create。
conan create 为什么会跳过 build 阶段
当你执行 conan create . user/channel 时,Conan 默认会检查本地缓存中是否存在「完全匹配」的二进制——即 settings + options + requires 计算出的 ID 和已有包 ID 一致。如果一致,它直接复用,不运行 build() 方法。
想让它一定走 build 流程,必须打破 ID 一致性。常用手段包括:
- 临时修改
settings,比如加一个无意义但影响 ID 的字段:conan create . user/channel -s compiler.version=12.3.4 - 改
options,哪怕只是翻转一个布尔值:conan create . user/channel -o shared=True - 在
conanfile.py中给version加个时间戳后缀,让版本号变化 → ID 变化
单纯删掉 ~/.conan2/p/ 下的构建目录没用,ID 没变,下次仍会跳过。
已有二进制文件,怎么绕过 build 直接打包成新包
如果你手头已经有编译好的 .a、.so、.lib 等文件,不想再跑一遍 build(),就别用 conan create,改用 conan export-pkg。
它跳过 source/download/build 全流程,只做两件事:按 package() 逻辑拷贝文件 + 写入元数据到缓存。
典型流程:
- 确保你的
conanfile.py中package()方法能正确识别本地二进制路径(比如self.copy("*.lib", src="build/lib", dst="lib")) - 运行:
conan export-pkg . pkgname/1.0@user/channel --profile=default - 注意:必须指定
--profile,否则 Conan 无法计算 ID,会报错Profile not found
这个命令不会碰你原来的构建产物,也不会清空 IDE 缓存,适合快速迭代预编译 artifact。
private require 是防止 ID 漂移的关键点
很多“本该命中缓存却强制重编”的问题,根源是依赖传递导致 ID 被覆盖。比如项目 A 依赖 DBoW(要求 opencv/2.4),而项目 B 又引入了 opencv/4.8,Conan 默认把 opencv/4.8 “提升”为整个图的 opencv 版本,导致 DBoW 的二进制 ID 实际变成 opencv/4.8 对应的 ID,跟缓存里 opencv/2.4 的 ID 不匹配。
解决方法是在 DBoW 的 conanfile.py 中声明:
requires = [("opencv/2.4.13", "private")]
加 "private" 后,opencv/2.4.13 不再参与上层 ID 计算,DBoW 的二进制 ID 就稳定了。这点容易被忽略,但直接影响你能否复用预编译包。











