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

Conan怎么在CMake里使用静态库依赖

胖浩吖_1227

胖浩吖_1227

发布时间:2026-09-25 12:45:37

|

873人浏览过

|

来源于php中文网

原创

不能,find_package默认查找库的接口定义而非静态/动态形态;Conan生成的Config.cmake根据安装选项决定暴露静态或动态target,需显式设shared=False并验证IMPORTED_LOCATION指向.a文件。

conan怎么在cmake里使用静态库依赖

find_package 能直接找到静态库吗

不能,默认情况下 find_package 找到的是库的“接口定义”,不是静态/动态形态本身。Conan 生成的 xxxConfig.cmake(比如 fmtConfig.cmake)里会根据你安装时的构建配置,决定暴露 fmt::fmt 是链接静态库还是动态库——这取决于 Conan 包本身的 package_id 策略和你 conan install 时的 -s build_type=Release、-o shared=False 等设置。

关键点在于:Conan 不控制 CMake 如何链接,它只提供可被 find_package 消费的 target;最终链接静态还是动态,由 Conan 包作者在 package() 和 cpp_info.libs 中声明,以及你在 conanfile.py 或 conanfile.txt 中传入的选项共同决定。

如何确保链接的是静态库

必须显式开启静态构建选项,并确认包支持该模式。常见错误是以为只要 find_package(xxx REQUIRED) 就自动静态链接,其实默认可能走动态路径。

  • conan install . --build=missing -o xxx:shared=False:对每个依赖加 -o :shared=False,强制其构建/使用静态版本(前提是该包支持此选项,如 fmt、spdlog 默认支持,openssl 则需额外指定 no_shared)
  • 在 conanfile.py 的 requirements() 或 configure() 中写死:
    def configure(self):
        self.options["fmt"].shared = False
        self.options["spdlog"].shared = False
  • 检查生成的 xxxTargets.cmake 文件(通常在 build/conan/xxx/xxxTargets.cmake),搜索 IMPORTED_LOCATION 或 IMPORTED_LOCATION_RELEASE,确认路径指向的是 .a 文件而非 .so 或 .dll

CMakeLists.txt 里怎么写才不踩坑

很多人在 target_link_libraries() 后发现链接失败或运行时报 undefined symbol,问题常出在头文件路径、依赖顺序或隐式依赖缺失上。

正确写法示例(Conan 2.x + CMakeDeps):

Conan 2.31.2
Conan 2.31.2

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

下载
cmake_minimum_required(VERSION 3.15)
project(myapp LANGUAGES CXX)
<h1>必须先加载 Conan 工具链,再 find_package</h1><p>include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake)</p><p>find_package(fmt REQUIRED CONFIG)
find_package(spdlog REQUIRED CONFIG)</p><p>add_executable(myapp main.cpp)
target_link_libraries(myapp PRIVATE fmt::fmt spdlog::spdlog)</p><h1>静态库依赖常需额外链接系统库(如 pthread、dl)</h1><p>target_link_libraries(myapp PRIVATE ${CMAKE_DL_LIBS} pthread)

注意几个硬性要求:

  • include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake) 必须在 find_package() 之前,否则 CMake 不知道去哪里找 fmtConfig.cmake
  • 不要手动 target_include_directories(... PUBLIC ${CONAN_INCLUDE_DIRS_FMT}) —— Conan 2.x 的 CMakeDeps 已通过 INTERFACE_INCLUDE_DIRECTORIES 自动注入
  • 如果依赖链中有 header-only 库(如 nlohmann_json),它不会生成 .a,但 find_package(nlohmann_json REQUIRED) 依然有效,只是不参与链接阶段

install 后静态库文件去哪儿了

Conan 安装后的静态库不会落到你的项目目录,而是存于 Conan 本地缓存(如 ~/.conan2/p/fmt/...),CMake 通过 IMPORTED_LOCATION 属性间接引用。你不需要、也不应该手动 install(TARGETS ... ARCHIVE DESTINATION ...) 这些 Conan 提供的库。

真正需要你 install 的,是你自己的 target:

install(TARGETS myapp
  RUNTIME DESTINATION bin
  # 不要试图 install(fmt::fmt) —— 它不是你的 target,且 Conan 已管理其部署逻辑
)

容易忽略的一点:如果你把项目打包成 SDK 或分发给他人,必须同时提供 Conan lockfile(conan.lock)和 conanfile.py,否则对方无法复现相同的静态链接行为——尤其是当某个依赖在不同平台下默认构建策略不一致时(比如 Windows 下 zlib 可能默认用 DLL,Linux 下默认静态)。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

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

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

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

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

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

DeepSeek

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

相关专题

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

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

5526

2025.10.17

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

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

1431

2025.10.23

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

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

334

2025.12.13

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

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

120

2026.09.23

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

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

60

2026.09.23

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

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

40

2026.09.23

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

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

40

2026.09.22

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

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

40

2026.09.22

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

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

40

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