Conan CMake最小示例怎么写

千枫大大_8214

千枫大大_8214

2026-09-21

405人浏览

原创

conan+cmake最小可运行示例需严格包含两步:先执行conan install .. --build=missing生成build/generators/下的conan_toolchain.cmake和fmt-config.cmake,再在cmakelists.txt中include()该toolchain并find_package(fmt config required)链接fmt::fmt。

conan cmake最小示例怎么写

Conan + CMake 最小可运行示例,必须包含 conan installfind_package 两步,缺一不可;否则 target_link_libraries 会报 Unknown CMake command "find_package" 或链接失败。

conanfile.txt 必须声明依赖并启用 CMake generator

不要用空的 conanfile.py 或直接跳过依赖声明。最小配置只需三行:

  • [requires] 指定你要用的库,例如 fmt/10.2.1
  • [generators] 必须含 CMakeDeps(生成 xxxConfig.cmake)和 CMakeToolchain(统一编译参数)
  • 不写 [options][settings] 也能跑通,但首次运行 conan install 时会自动推导本地环境

示例 conanfile.txt

#[requires]
fmt/10.2.1

#[generators]
CMakeDeps
CMakeToolchain

CMakeLists.txt 要先 include toolchain,再 find_package

顺序错了就找不到包:include() 必须在 project() 之后、find_package() 之前;否则 CMAKE_PREFIX_PATH 未生效,find_package(fmt CONFIG REQUIRED) 会失败。

CMake 4.3.2
CMake 4.3.2

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

下载
  • include(${CMAKE_CURRENT_LIST_DIR}/build/generators/conan_toolchain.cmake) —— 路径要和 conan install 输出一致,默认是 build/generators/
  • find_package(fmt CONFIG REQUIRED) —— CONFIG 表示走 Config 模式,依赖 Conan 生成的 fmt-config.cmake
  • target_link_libraries(myapp PRIVATE fmt::fmt) —— 别漏掉 ::fmt 是 target 名,不是头文件名

最小 CMakeLists.txt

cmake_minimum_required(VERSION 3.15)
project(myapp LANGUAGES CXX)

include(${CMAKE_CURRENT_LIST_DIR}/build/generators/conan_toolchain.cmake)

set(CMAKE_CXX_STANDARD 17)
add_executable(myapp src/main.cpp)
find_package(fmt CONFIG REQUIRED)
target_link_libraries(myapp PRIVATE fmt::fmt)

构建流程不能跳过 conan install

很多人以为 cmake .. 就能自动拉依赖,实际不会。conan install 是独立命令,必须显式执行,且需指定构建目录(通常为 build):

  • mkdir build && cd build
  • conan install .. --build=missing -s build_type=Release —— --build=missing 确保没二进制时自动编译
  • 执行后会在 build/generators/ 下生成 conan_toolchain.cmakefmt-config.cmake 等文件
  • 再运行 cmake .. && cmake --build . 才能成功编译

常见错误:fmt::fmt 找不到或链接失败

最常踩的坑不是语法,而是路径和命名不匹配:

  • conan install 在哪个目录下执行,include() 就得指向对应 build/generators/ —— 如果你在 build/rel 里装,include 就不能写死 build/generators
  • find_package(fmt CONFIG REQUIRED) 中的 fmt 必须和 conanfile.txt 里写的包名完全一致(大小写敏感),fmt/10.2.1fmt,不是 fmtlibfmtxx
  • 如果用的是 C 项目(非 CXX),别设 LANGUAGES CXX,也别用 fmt::fmt —— 改用纯 C 库如 zlib,并用 find_package(ZLIB REQUIRED) + target_link_libraries(myapp PRIVATE ${ZLIB_LIBRARIES})

真正麻烦的从来不是写几行 CMake,而是 conan install 生成的路径和 CMakeLists.txt 里写的路径对不上,或者包名大小写/拼写差一个字符 —— 这类问题不会报错“找不到 conan”,只会静默失败,然后卡在 find_package

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

cmake

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2025.10.17

5266

15

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

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

2025.10.23

1371

14

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

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

2025.12.13

314

18

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

0

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

0

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

2026.09.21

0

17

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

2026.09.21

0

12

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

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

2026.09.20

20

13

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习