冠军资讯
半杯凉茶在 Linux C++ 项目开发中，CMake 是我们常用的构建工具。很多开发者在使用 CMake 构建项目时，经常会遇到动态库和静态库的选择及配置问题，尤其是在项目变得复杂之后，依赖关系错综复杂，更容易出现编译链接错误。本文将深入探讨 CMake 构建动态库和静态库的底层原理、配置方法，并分享一些实战中的避坑经验。
动态库与静态库的区别
首先，我们需要理解动态库和静态库的本质区别。静态库（.a 或 .lib）在链接时会被完整地复制到可执行文件中，这意味着每个使用该静态库的可执行文件都会包含一份完整的库代码。而动态库（.so 或 .dll）则是在程序运行时才会被加载到内存中，多个程序可以共享同一份动态库，从而节省磁盘空间和内存资源。
静态库的优点是程序运行时不需要依赖外部库，部署方便。缺点是可执行文件体积较大，并且如果静态库更新，所有使用该静态库的可执行文件都需要重新编译。
动态库的优点是可执行文件体积较小，库更新方便，只需要替换动态库文件即可。缺点是程序运行时需要依赖外部库，部署时需要确保动态库存在，并且版本匹配。
CMake 构建静态库
下面是一个简单的 CMake 构建静态库的例子：
# CMakeLists.txt
cmake_minimum_required(VERSION 3.0)
project(my_static_lib)
add_library(my_static STATIC my_static_lib.cpp)
add_library 命令用于定义一个库。第一个参数是库的名称，第二个参数 STATIC 表示创建一个静态库，后面的参数是源文件列表。
编译命令如下：
mkdir build
cd build
cmake ..
make
编译成功后，会在 build 目录下生成 libmy_static.a 文件。
CMake 构建动态库
下面是一个简单的 CMake 构建动态库的例子：
# CMakeLists.txt
cmake_minimum_required(VERSION 3.0)
project(my_shared_lib)
add_library(my_shared SHARED my_shared_lib.cpp)
与静态库相比，唯一的区别是将 STATIC 替换为 SHARED。
编译命令与静态库相同：
mkdir build
cd build
cmake ..
make
编译成功后，会在 build 目录下生成 libmy_shared.so 文件。
CMake 链接动态库与静态库
无论是链接动态库还是静态库，都可以使用 target_link_libraries 命令。
# CMakeLists.txt
cmake_minimum_required(VERSION 3.0)
project(my_app)
add_executable(my_app main.cpp)
target_link_libraries(my_app my_static my_shared)
# 设置rpath，运行时寻找动态库
set_target_properties(my_app PROPERTIES
RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin"
LIBRARY_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib"
CMAKE_BUILD_WITH_INSTALL_RPATH TRUE
CMAKE_INSTALL_RPATH "$ORIGIN/../lib"
)
target_link_libraries 命令用于指定可执行文件需要链接的库。第一个参数是可执行文件的名称，后面的参数是库的名称。
注意，CMake 会自动处理库的依赖关系。如果 my_shared 依赖于其他库，CMake 会自动将这些依赖库也链接到 my_app 中。
设置rpath非常重要，尤其是在Linux环境下。它告诉操作系统在哪里寻找动态库，避免程序运行时找不到动态库。
实战避坑经验
库的版本冲突：当项目依赖多个动态库时，可能会出现库的版本冲突问题。可以使用
ldd命令查看可执行文件依赖的动态库及其版本。解决版本冲突的方法包括升级或降级库版本，或者使用不同的命名空间来避免符号冲突。循环依赖：如果两个库互相依赖，会导致编译错误。可以使用
INTERFACE库来解决循环依赖问题。INTERFACE库只包含头文件，不包含实现代码，可以用来声明库的接口，从而打破循环依赖。忘记设置 RPATH：在 Linux 环境下，如果动态库不在系统默认的搜索路径中，需要设置 RPATH 才能让程序找到动态库。可以使用
set_target_properties命令设置 RPATH。使用 find_package 查找依赖库：尽量使用
find_package命令来查找依赖库，而不是手动指定库的路径。find_package命令可以自动查找库的头文件和库文件，并且可以处理库的依赖关系。静态库与动态库混用：尽量避免在同一个项目中使用静态库和动态库混用。如果必须混用，需要仔细考虑库的依赖关系，避免出现链接错误。可以使用
-fPIC选项编译动态库，避免地址无关代码的问题。
动态库和静态库的 CMake 实践与 Nginx 模块开发
在实际项目中，选择动态库还是静态库，需要根据具体情况进行权衡。如果项目需要频繁更新，或者需要节省磁盘空间和内存资源，那么动态库是更好的选择。如果项目对性能要求较高，或者需要避免依赖外部库，那么静态库是更好的选择。
例如，在开发 Nginx 模块时，通常会将模块编译成动态库，然后通过 load_module 指令加载到 Nginx 中。这样做的好处是可以方便地更新模块，而不需要重新编译 Nginx。 Nginx 的负载均衡、反向代理等功能都可以通过加载不同的动态模块来实现。如果使用宝塔面板，也可以很方便地管理 Nginx 及其模块。
然而，在一些嵌入式系统中，由于资源有限，通常会选择使用静态库。这样做的好处是可以减少程序的体积，并且可以避免依赖外部库。
总之，理解动态库和静态库的区别，以及 CMake 的配置方法，是开发高质量 C++ 项目的基础。希望本文能够帮助读者更好地理解和使用 CMake，避免在实际开发中遇到各种坑。
