如何完全静态编译Qt Widgets项目？VS环境下能否实现及操作方法？

Qt Widgets项目可以实现完全静态编译，生成的可执行文件无需附带任何Qt DLL、C++标准库DLL或系统依赖DLL。以下是针对Windows + Visual Studio环境的具体操作步骤：

一、编译静态版本的Qt库 #

官方默认提供的Qt安装包为动态库版本，必须自行编译静态库才能实现完全静态编译：

• 下载对应版本的Qt源码包（如Qt 5.15.x、Qt 6.x），解压到无中文、无空格的本地路径。
• 打开对应版本的Visual Studio命令提示符（如VS2019 x64 Native Tools Command Prompt），切换到Qt源码根目录。
• 执行configure配置命令（以Qt 5为例）：

  configure -static -release -prefix "D:\Qt\Static\5.15.2" -opensource -confirm-license -nomake examples -nomake tests -skip qtwebengine
  

  参数说明：
  • -static：指定静态编译模式
  • -release：仅编译发布版本
  • -prefix：编译后静态库的安装路径
  • -nomake examples/tests：跳过示例和测试，加快编译速度
  • -skip qtwebengine：跳过无需使用的模块（按需调整）
    Qt 6的配置命令类似，调整路径和模块即可：

  configure.bat -static -release -prefix "D:\Qt\Static\6.5.0" -opensource -confirm-license -nomake examples -nomake tests
  

• 执行编译安装：输入nmake（或用jom加快编译速度，需提前安装jom），编译完成后输入nmake install，等待静态库安装到指定路径。

二、在Visual Studio中配置静态编译项目 #

• 打开Visual Studio，通过Qt VS Tools插件创建或导入Qt Widgets项目。
• 配置Qt版本：打开Qt VS Tools的「Qt Version Manager」，添加刚才编译好的静态Qt版本（选择安装路径下的bin/qmake.exe），并将项目的Qt版本切换为该静态版本。
• 修改项目属性：
  • 右键项目 → 属性 → 配置属性 → Qt Project Settings：确认Qt版本为静态版本。
  • 配置属性 → C/C++ → 所有选项：将「Runtime Library」设置为Multi-threaded (/MT)（发布版本），确保静态链接C++标准库。
  • 若项目基于qmake，需修改.pro文件，添加以下配置：

    CONFIG += static
    QTPLUGIN += qwindows  # Windows平台必须添加，确保窗口正常渲染
    QMAKE_LFLAGS += /NODEFAULTLIB:MSVCRT  # 强制链接静态C++库
    

• 切换到Release配置，点击「生成解决方案」，编译完成后得到的exe即为完全静态的可执行文件，无需附带任何DLL。

三、关键注意事项 #

• 静态编译生成的exe体积会远大于动态编译版本，属于正常现象。
• 若项目依赖第三方库（如OpenCV、SQLite等），必须使用这些库的静态版本，否则仍会存在DLL依赖。
• Qt 6的静态编译流程与Qt 5基本一致，但部分模块的配置参数可能有变化，需参考对应版本的官方文档调整。

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