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

Conan生成的CMake文件应该怎么用

秋涛吖_5507

秋涛吖_5507

发布时间:2026-09-25 14:50:19

|

225人浏览过

|

来源于php中文网

原创

conan install 生成的文件在指定输出目录(如 build/)根目录下,包括 conan_toolchain.cmake 和 xxx-config.cmake(如 fmt-config.cmake),以及 generators/ 子目录;其中 conan_toolchain.cmake 含编译配置,xxx-config.cmake 供 find_package 使用。

conan生成的cmake文件应该怎么用

conan install 生成的文件在哪、叫什么

Conan 不会自动修改你的 CMakeLists.txt,它只负责在你指定的输出目录(比如 build)里生成一堆 .cmake 文件。关键就两点:你得知道它生成了啥,以及 CMake 怎么找到它们。

典型命令是:conan install . --output-folder=build --build=missing。执行后,build/ 下会出现:

  • conan_toolchain.cmake:含编译器标志、标准、架构等设置
  • fmt-config.cmake(或类似名字,如 boost-config.cmake):供 find_package(fmt) 加载的配置模块
  • generators/ 目录(旧版可能直接平铺):现代 Conan 2.x 默认把生成文件放进这里

注意:conan_toolchain.cmake 的路径必须和你在 CMake 中 include() 的路径一致;如果用 --output-folder=build,那它就在 build/conan_toolchain.cmake,不是 build/generators/ 里。

在 CMakeLists.txt 中怎么正确 include 这些文件

顺序和位置直接影响能否链接成功。错误写法(比如放在 project() 前)会导致 CMAKE_TOOLCHAIN_FILE 未生效,C++ 标准或编译器选项被忽略。

正确做法(Conan 2.x + CMake 3.23+ 推荐):

  • include() 必须放在 project() 之后、任何 add_executable() 或 find_package() 之前
  • include() 路径要基于 CMAKE_CURRENT_LIST_DIR 或 CMAKE_BINARY_DIR,不能硬编码相对路径
  • 推荐用 ${CMAKE_BINARY_DIR}/conan_toolchain.cmake,因为 conan install 默认把 toolchain 放到 output folder 根目录

示例片段:

Conan 2.31.2
Conan 2.31.2

Conan 2.31.2 官方历史源码包,适合复现依赖解析、CMake 配置、二进制包兼容性和跨平台构建环境。

下载
cmake_minimum_required(VERSION 3.23)
project(hello LANGUAGES CXX)
<h1>✅ 正确:project 后立即 include,且路径可移植</h1><p>include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake)</p><p>set(CMAKE_CXX_STANDARD 17)
add_executable(hello src/main.cpp)</p><h1>✅ find_package 在 include 之后,才能读到 Conan 生成的 config</h1><p>find_package(fmt REQUIRED)
target_link_libraries(hello PRIVATE fmt::fmt)

find_package(fmt) 找不到包?检查三个关键点

常见报错是 find_package(fmt REQUIRED) 失败,提示 “Could not find a package configuration file provided by ‘fmt’”。这不是 CMake 问题,而是 Conan 生成或 CMake 查找路径没对齐。

  • 确认 conan install 是否真的成功执行,并生成了 fmt-config.cmake(或 fmtConfig.cmake)—— 它必须出现在 CMAKE_PREFIX_PATH 搜索范围内
  • 确保 generators = "CMakeDeps" 已声明(conanfile.py)或 [generators] CMakeDeps 已写入(conanfile.txt),否则不会生成 *-config.cmake
  • 检查 CMake 是否收到 CMAKE_PREFIX_PATH:Conan 的 CMakeDeps 生成器会把路径注入该变量;但如果你手动调用 cmake .. 而没传 -DCMAKE_TOOLCHAIN_FILE=...,toolchain 不生效,CMake 就不知道去哪找

简单验证方法:运行 cmake -L -N .. 看输出里有没有 CMAKE_PREFIX_PATH,它的值应该包含 Conan 生成文件所在目录。

为什么有时要同时用 CMakeToolchain 和 CMakeDeps

这两个生成器分工明确,缺一不可:

  • CMakeToolchain 解决“怎么编译”:统一 C++ 标准、编译器定义、构建类型(Debug/Release)、平台宏(WIN32, __linux__)等,避免手动在 CMakeLists.txt 里重复设 set(CMAKE_CXX_STANDARD ...)
  • CMakeDeps 解决“用什么库”:生成每个依赖的 *-config.cmake,让 find_package(Xxx) 可以定位头文件路径、链接库名、依赖传递关系

漏掉 CMakeToolchain → 编译可能失败(比如用了 C++20 特性但 CMake 还按 C++14 编);漏掉 CMakeDeps → find_package 找不到库,链接时报 undefined reference。两者都启用才是 Conan 2.x 的标准集成方式。

热门AI工具

更多
超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

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

WorkBuddy

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

DeepSeek

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

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

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

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

5466

2025.10.17

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

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

1411

2025.10.23

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

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

334

2025.12.13

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

20

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

20

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

20

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

20

2026.09.22

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

20

2026.09.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 入门教程
Conan 2 入门教程

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

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

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