Linux下CMake始终链接动态库而非静态库及GTK3依赖缺失问题

一、CMake始终链接动态库的原因及修复 #

核心原因 #

1. 静态查找优先级未生效：你设置了CMAKE_FIND_LIBRARY_SUFFIXES .a .lib，但像wxWidgets这类用CONFIG模式查找的库，其预生成配置文件会直接指定库路径和类型，绕过后缀优先级设置。
2. 未给所有库开启静态查找选项：除Boost外，OpenSSL、cpprestsdk等库默认优先查找动态库，你没设置对应的静态启用参数。
3. -static参数使用不规范：全局link_libraries("-static")会强制所有库静态链接，但部分系统库可能没有静态版本，反而引发冲突；在target_link_libraries里零散添加-static也无法全局生效。

修复步骤 #

1. 提前设置全局静态优先级：
   把静态后缀设置移到最顶部（project命令之前），同时全局禁用动态库构建：

   cmake_minimum_required(VERSION 3.20)
   # 优先查找静态库
   set(CMAKE_FIND_LIBRARY_SUFFIXES .a .lib)
   # 全局默认构建静态库
   set(BUILD_SHARED_LIBS OFF)
   list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_LIST_DIR}/cmake/Modules/")
   set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<$<CONFIG:Debug>:Debug>")
   project(MyProject)
   

2. 为每个库显式开启静态查找：
   给所有依赖库添加静态启用参数，确保find_package只查找静态版本：

   # Boost 静态链接
   set(Boost_USE_STATIC_LIBS ON)
   find_package(Boost COMPONENTS filesystem system iostreams locale serialization chrono program_options REQUIRED)
   
   # OpenSSL 静态链接
   set(OPENSSL_USE_STATIC_LIBS ON)
   find_package(OpenSSL 3.0 REQUIRED)
   
   # cpprestsdk 静态链接
   set(CPPRESTSDK_USE_STATIC_LIBS ON)
   find_package(cpprestsdk REQUIRED NAMES cpprestsdk cpprest)
   
   # Botan 静态链接
   set(BOTAN_USE_STATIC_LIBS ON)
   find_package(Botan REQUIRED)
   
   # PostgreSQL 静态链接
   set(PostgreSQL_USE_STATIC_LIBS ON)
   find_package(PostgreSQL REQUIRED)
   
   # 强制查找pqxx静态库
   find_library(PQXX_LIB NAMES libpqxx.a pqxx)
   

3. 规范静态链接参数：
   移除全局link_libraries("-static")，改为给目标单独设置静态链接选项：

   target_link_options(${PROJECT_NAME} PRIVATE -static)
   

二、静态wxWidgets找不到GTK3依赖的原因及解决 #

核心原因 #

静态编译wxWidgets时，它会依赖GTK3的静态库（.a文件），但你的系统只安装了GTK3的动态开发包（仅含.so文件），没有安装静态版本的开发库，因此链接器找不到对应的.a文件。

解决步骤 #

1. 安装GTK3及依赖的静态开发包：
   在Debian/Ubuntu系系统中，执行以下命令安装所有需要的静态库开发包：

   sudo apt-get install libgtk-3-dev libgdk-pixbuf2.0-dev libpango1.0-dev libatk1.0-dev libcairo2-dev libpangocairo-1.0-dev
   

   这些包会将静态库文件放到/usr/lib/x86_64-linux-gnu/目录下。
2. 重新配置wxWidgets以识别静态GTK3：
   重新编译wxWidgets时，添加强制查找静态GTK3库的参数：

   cmake -G "Unix Makefiles" /home/datahdd/SDKs/wxWidgets-3.2.1 \
     -DwxBUILD_SHARED=OFF \
     -DwxUSE_WEBVIEW=true \
     -DwxUSE_LIBJPEG=builtin \
     -DwxUSE_LIBPNG=builtin \
     -DwxUSE_ZLIB=builtin \
     -DwxUSE_LIBTIFF=builtin \
     -DwxUSE_REGEX=builtin \
     -DwxUSE_EXPAT=builtin \
     -DwxBUILD_MONOLITHIC=OFF \
     -DGTK3_USE_STATIC_LIBS=ON
   

3. 在项目CMake中显式查找静态GTK3：
   在你的项目CMakeLists里添加GTK3的静态查找逻辑，确保链接时能找到静态库：

   set(GTK3_USE_STATIC_LIBS ON)
   find_package(GTK3 REQUIRED)
   target_link_libraries(${PROJECT_NAME} ${GTK3_LIBRARIES})
   

内容的提问来源于stack exchange，提问作者Jono M