导出与导入：export命令、install(EXPORT)、创建包配置文件、find_package集成
好，咱们今天聊一个让很多CMake新手头疼、但又是大型项目必备的话题——导出与导入。
说白了，就是怎么把你的库“打包好”给别人用，以及怎么优雅地“拿过来”别人打包好的库。我刚开始接触CMake那会儿，总觉得只要把库编译出来、头文件扔过去就行了。直到有一次，我接手一个同事留下的项目，他直接把所有.a文件和头文件散落在各个目录里，我花了整整两天才把依赖链理清楚……嗯，从那以后，我再也不敢轻视导出与导入的设计了。
一、export命令：给“内部”项目用的快捷方式
export()命令，我个人习惯叫它“轻量级导出”。它不会把文件安装到系统里，而是在构建目录里生成一个.cmake文件，供同一个项目里的其他子项目使用。
举个例子：
add_library(my_lib STATIC src/my_lib.cpp)
target_include_directories(my_lib PUBLIC include)
# 导出目标
export(TARGETS my_lib FILE MyLibTargets.cmake)
执行完cmake --build .后，构建目录里会多出一个MyLibTargets.cmake。其他子项目只要用include()把它加载进来，就能直接使用my_lib这个目标了。
export()，方便快速调试。正式发布时，我会改用install(EXPORT)，因为后者更规范、更持久。
二、install(EXPORT)：给“外部”用户准备的正式接口
install(EXPORT)才是真正的“发布级”导出。它会把目标信息写入安装目录，配合install(TARGETS)一起使用。
看一个完整的例子：
add_library(my_math STATIC src/add.cpp src/sub.cpp)
target_include_directories(my_math PUBLIC include)
# 安装目标文件和头文件
install(TARGETS my_math
EXPORT MyMathTargets
ARCHIVE DESTINATION lib
INCLUDES DESTINATION include
)
install(DIRECTORY include/ DESTINATION include)
# 安装导出的cmake文件
install(EXPORT MyMathTargets
FILE MyMathTargets.cmake
DESTINATION lib/cmake/MyMath
)
安装后，用户只要在CMakeLists.txt里写：
include(/usr/local/lib/cmake/MyMath/MyMathTargets.cmake)
target_link_libraries(my_app my_math)
就能直接用了。不过，这种方式要求用户知道.cmake文件的具体路径，不够友好。所以，我们还需要包配置文件。
三、创建包配置文件：让find_package自动找到你
包配置文件，说白了就是给find_package()准备的“说明书”。它通常包含两个文件：
- MyMathConfig.cmake：主配置文件，负责加载目标文件或定义变量。
- MyMathConfigVersion.cmake：版本文件，用于版本兼容性检查。
我建议你直接在项目根目录下创建一个cmake/文件夹，专门放这些配置文件。比如：
# cmake/MyMathConfig.cmake
include("${CMAKE_CURRENT_LIST_DIR}/MyMathTargets.cmake")
然后在CMakeLists.txt里安装它：
install(FILES cmake/MyMathConfig.cmake cmake/MyMathConfigVersion.cmake
DESTINATION lib/cmake/MyMath
)
这样，用户只需要写：
find_package(MyMath REQUIRED)
target_link_libraries(my_app my_math)
CMake会自动在lib/cmake/MyMath/目录下找到MyMathConfig.cmake，然后加载目标文件。是不是清爽多了？
find_package()的第一个参数完全一致，大小写敏感！比如find_package(MyMath)会找MyMathConfig.cmake，而不是mymathconfig.cmake。我因为这个大小写问题排查了整整一个下午……
四、find_package集成：两种模式，你选哪种？
find_package()有两种工作模式：模块模式和配置模式。
| 模式 | 查找方式 | 典型场景 |
|---|---|---|
| 模块模式 | 查找Find<PackageName>.cmake模块文件 |
系统自带库（如FindThreads） |
| 配置模式 | 查找<PackageName>Config.cmake配置文件 |
第三方库、自己发布的库 |
对于我们自己的库，当然是用配置模式。CMake会按照CMAKE_PREFIX_PATH、系统路径等顺序去搜索。你想想看，只要把安装目录加到CMAKE_PREFIX_PATH里，find_package就能自动找到。
举个例子，假设你把库安装到了/opt/my_libs，那么用户只需要：
cmake -DCMAKE_PREFIX_PATH=/opt/my_libs ..
然后find_package(MyMath REQUIRED)就能成功。是不是很简单？
五、知识体系总览
为了让你更直观地理解整个流程，我画了一张图：
从这张图你可以看到，整个流程分为三个阶段：
- 构建阶段：用
export()快速生成目标文件，方便内部调试。 - 安装阶段：用
install(EXPORT)把目标文件安装到系统路径，并配上包配置文件。 - 使用阶段：用户通过
find_package()自动找到并加载你的库。
六、避坑指南与个人经验
最后，分享几个我实际项目中遇到的坑：
- 路径问题：包配置文件里引用其他文件时，一定要用
${CMAKE_CURRENT_LIST_DIR}，而不是硬编码路径。否则用户换个安装目录就找不到了。 - 接口一致性：导出的目标名必须和
install(TARGETS)里的一致。我见过有人手抖写错名字，结果find_package成功了但链接失败，排查起来特别痛苦。 - 版本文件：别偷懒不写版本文件。没有版本文件，
find_package的EXACT和版本范围检查都会失效。我曾经因为版本号写错，导致用户用了一个不兼容的旧版本，出了线上bug……
核心总结：
- 开发时用
export()，发布时用install(EXPORT)。 - 包配置文件是
find_package的入口，必须命名正确、路径正确。 - 版本文件不是可选项，是必选项。
好了，关于导出与导入的内容就聊到这里。记住，好的导出设计，能让你的库用户用得舒心，也能让你自己少接几个“为什么我链接不上”的咨询电话。