讲师中心 微信公众号
AI工具推荐 视频效率加速

Conan怎么让CMake自动找到依赖库

星强小哥_2425

星强小哥_2425

发布时间:2026-09-21 14:06:16

|

912人浏览过

|

来源于php中文网

原创

Conan 生成的 xxxConfig.cmake 文件位于 build/generators/ 目录下(如 fmtConfig.cmake),由 CMakeDeps 生成器创建,需通过 include(${CMAKE_BINARY_DIR}/generators/conan_deps.cmake) 或将该路径加入 CMAKE_PREFIX_PATH 才能被 find_package(... CONFIG) 正确加载。

conan怎么让cmake自动找到依赖库

Conan 生成的 xxxConfig.cmake 文件在哪?

Conan 不是靠“告诉 CMake 去哪找”,而是直接生成 CMake 能原生识别的配置文件。关键在于:CMakeDeps 生成器会在你指定的输出目录(比如 build/generators/)下,为每个依赖创建一个 <packagename>Config.cmake</packagename>(如 fmtConfig.cmake)和配套的 xxxTargets.cmake。这些文件就是 find_package(fmt CONFIG) 实际加载的对象。

常见错误现象:CMake 报错 By not providing "Findfmt.cmake" in CMAKE_MODULE_PATH —— 这说明你用了 find_package(fmt)(Module 模式),但 Conan 默认只提供 Config 模式文件,没生成 Findfmt.cmake

  • 必须用 find_package(fmt REQUIRED CONFIG),显式指定 Config 模式
  • CMakeDeps 是 Conan 2.x 的默认推荐生成器,cmake_find_package 已弃用
  • 生成路径必须被 CMake 知道:通常通过 include(${CMAKE_BINARY_DIR}/generators/conan_deps.cmake) 加载(注意不是直接 include 单个 xxxConfig.cmake)

find_package(... CONFIG) 为什么还是找不到?

Config 模式查找依赖的核心是 CMAKE_PREFIX_PATH。Conan 生成的 fmtConfig.cmake 文件本身会硬编码其所在目录作为“安装前缀”,而 CMake 只有在 CMAKE_PREFIX_PATH 中包含该目录时,才能顺着它找到所有子模块。

容易踩的坑:你运行了 conan install . -if build,但 CMakeLists.txt 里没把 build/generators 加进 CMAKE_PREFIX_PATH,CMake 就根本不会去那个目录扫描 fmtConfig.cmake

CMake 4.3.2
CMake 4.3.2

CMake 4.3.2 Windows x86_64 历史版本安装包,适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。

下载
  • 最稳妥的做法是在 CMakeLists.txt 开头加:list(APPEND CMAKE_PREFIX_PATH "${CMAKE_BINARY_DIR}/generators")
  • 或者更推荐:用 include() 显式加载 Conan 生成的入口文件,例如 include(${CMAKE_BINARY_DIR}/generators/conan_deps.cmake)(该文件由 CMakeDeps 自动生成,会内部设置好路径)
  • 不要依赖 -DCMAKE_PREFIX_PATH=... 命令行传参——容易漏、难复现,尤其 CI 场景

Conan 和 CMake 的 settings 必须严格对齐

Conan 下载或构建的二进制包 ID,由 osarchcompilerbuild_type 等 settings 共同决定。如果 conan install 用的是 -s compiler=gcc -s compiler.version=11,但 CMake 实际调用的是 clang,fmt::fmt 目标虽然能 find 到,链接时大概率报 undefined reference 或 ABI 不兼容。

典型表现:CMake 配置成功,编译也过,但链接失败,提示类似 undefined reference to `fmt::v8::printf(std::string_view, fmt::v8::format_args)'

  • 务必确保 conan install 命令中的 -s 参数与你后续运行 cmake .. 时实际使用的编译器完全一致
  • 使用 CMakeToolchain 生成器可自动导出 toolchain 文件,并在 CMake 中用 -DCMAKE_TOOLCHAIN_FILE=... 加载,比手动配 -s 更可靠
  • profile 文件(如 ~/.conan2/profiles/default)会影响默认 settings,建议显式指定 --profile=default 避免隐式行为

为什么 target_link_libraries(... fmt::fmt) 报错 “Unknown import target”?

这个错误意味着 find_package(fmt REQUIRED CONFIG) 成功执行了,但生成的 fmtTargets.cmake 里没有定义 fmt::fmt 这个别名目标。根本原因通常是 Conan 包本身未导出 CMake 导入目标(比如旧版包或自建包未正确配置 cpp_info.set_property("cmake_target_name", ...))。

不是所有 Conan 包都默认提供 :: 命名空间目标;有些只提供 fmt(非命名空间)或 CONAN_PKG::fmt

  • 先检查生成的 fmtTargets.cmake 文件内容,搜索 add_library(fmt::fmtadd_library(fmt
  • 若只有 add_library(fmt),就改用 target_link_libraries(main PRIVATE fmt)
  • 若看到 CONAN_PKG::fmt,则用 CONAN_PKG::fmt
  • 优先选用官方 Conan Center 的包(如 fmt/10.2.1),它们基本都已适配标准 CMake 目标命名
真正卡住的地方往往不是“怎么写”,而是 conan install 的 settings 和 CMake 实际构建环境之间那层看不见的 ABI 对齐,以及 Config 模式下对 CMAKE_PREFIX_PATHinclude() 路径的精确控制。漏掉任意一环,find_package 就只是安静地失败。

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
C++ 跨平台开发
C++ 跨平台开发

本专题聚焦 C++ 在跨平台应用与工程构建中的实战应用,系统讲解 CMake 构建系统、跨平台编译配置、第三方库集成、调试技巧、静态与动态链接库管理等核心知识。通过实战案例(如跨平台工具开发、Linux与Windows编译兼容性项目),帮助学习者掌握 从环境配置到完整跨平台构建的开发能力。

5266

2025.10.17

c++  cmake用法
c++ cmake用法

本专题整合了c++ cmake用法相关教程,阅读专题下面的文章了解更多详细内容。

1371

2025.10.23

C++ 编译构建系统与CMake实战
C++ 编译构建系统与CMake实战

本专题聚焦 C++ 项目的编译与构建体系,系统讲解 CMake 的核心语法、项目结构设计、库与依赖管理、跨平台构建、调试与发布配置。通过完整项目示例,帮助开发者掌握 从源码到可执行程序的工程化构建流程,提升 C++ 项目在实际开发中的可维护性与扩展性。

314

2025.12.13

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

20

2026.09.20

AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程,涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能,帮助用户快速掌握AionClaw的实际使用方法。

0

2026.09.20

AI视频生成软件推荐
AI视频生成软件推荐

本专题汇总了当前主流的AI视频生成软件推荐与排行榜单,涵盖seko、AniShort、剧云、Lovart、LiblibAI及立刻mv等热门工具。同时整理了各软件在文生视频、图生视频、时长限制、画质表现及免费额度等方面的差异对比,助您快速选对适合创作需求的AI视频生成工具。

180

2026.09.16

ai生成视频的工具免费版合集
ai生成视频的工具免费版合集

本专题汇总了当前免费AI生成视频工具的排行榜与推荐清单,涵盖seko、讯飞智作、AniShort及剧云、Lovart等多模型集成平台。同时整理了各工具的免费额度、输出时长、水印政策及适用场景差异,助您快速选择合适工具开启AI视频创作。

100

2026.09.16

Pandas时间序列分析与可视化报表
Pandas时间序列分析与可视化报表

本专题整理Pandas日期转换、时间索引、重采样、滚动窗口、时区处理、plot绘图、Styler表格样式和报表输出方法。

80

2026.09.16

Pandas数据筛选索引与清洗处理
Pandas数据筛选索引与清洗处理

本专题整理Pandas中的loc、iloc、条件筛选、query查询、缺失值处理、重复值删除、类型转换和字符串列清洗方法。

60

2026.09.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CLion CMake 快速入门教程
CLion CMake 快速入门教程

共0课时 | 0人学习

CMake 保姆级教程
CMake 保姆级教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn