MSYS2下Qt 6静态编译失败，大量未定义符号问题求助

一、QMake项目的未定义符号（含Harfbuzz）问题 #

1. 显式声明依赖模块与插件
   静态编译Qt6不会自动导入插件和隐式依赖，需在.pro文件中补充：

   • 确保所有用到的Qt模块都声明：QT += core gui widgets（按需添加network、svg等其他模块）
   • 手动添加平台插件：QTPLUGIN += qwindows（Windows平台，其他平台替换对应插件名）
   • 显式链接Harfbuzz库：LIBS += -lharfbuzz，MSYS2的Qt6静态包依赖Harfbuzz静态库，可通过pacman -Qs harfbuzz检查是否安装

2. 完善静态构建配置
   在.pro中添加CONFIG += static，明确指定静态编译模式，避免混合动态依赖。

3. 更新MSYS2包
   执行pacman -Syu更新所有包，确保Qt6静态包及依赖（如Harfbuzz、Freetype）版本匹配，避免因版本差异导致符号缺失。

二、CMake项目编译后程序无法运行的问题 #

1. 强制静态链接C/C++运行时
   在CMakeLists.txt中添加编译与链接选项，确保静态链接MinGW的运行时库：

   set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -static")
   set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static")
   

2. 正确配置Qt6静态依赖

   • 确保find_package识别静态包（MSYS2的Qt6静态包会自动适配）：

     find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets)
     

   • 链接时添加必要的私有库（部分Qt模块的依赖仅存在于私有库中）：

     target_link_libraries(YourAppName PRIVATE Qt6::Core Qt6::Gui Qt6::Widgets Qt6::GuiPrivate)
     

   • 添加静态编译定义：

     target_compile_definitions(YourAppName PRIVATE QT_STATIC)
     

3. 手动注册平台插件
   静态Qt不会自动加载平台插件，需在main.cpp中添加插件导入代码：

   #include <QtPlugin>
   Q_IMPORT_PLUGIN(QWindowsIntegrationPlugin) // Windows平台
   

4. 检查依赖并验证
   在MSYS2终端中用ldd YourAppName.exe查看程序依赖，如果输出中仍有MinGW动态库（如libgcc_s_seh-1.dll），说明静态链接选项未生效，需检查CMake配置；若依赖仅为系统库，再排查插件注册等其他运行时问题。

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