如何静态链接Qt库？实现程序在无软件安装权限环境运行

云上老周

2026-5-26

我来帮你搞定Qt静态链接的CMake配置问题，这样你的计算器程序就能在学校那些没权限装软件的电脑上顺利运行了！

首先得指出你当前CMake配置里的几个关键问题：

直接把-lQt5Widgets这类链接参数塞到CMAKE_CXX_FLAGS里是不对的，CMake有专门的链接命令来处理库依赖，这么写会导致依赖解析出错。
find_package(Qt5...没写完，而且没告诉CMake要找静态版本的Qt库。
缺少Qt必备的MOC/UIC/RCC自动处理配置，这可是Qt程序编译的核心步骤。

下面是修正后的完整CMakeLists.txt，我会逐行给你解释：

cmake_minimum_required(VERSION 3.9)
project(Calculator)

# 开启详细编译输出，方便排查链接或编译问题
set(CMAKE_VERBOSE_MAKEFILE ON)
set(CMAKE_INCLUDE_CURRENT_DIR ON)

# 核心配置：告诉CMake我们要使用Qt的静态库版本
set(Qt5_USE_STATIC_LIBS ON)
# 如果你用的是Qt6，把上面改成 Qt6_USE_STATIC_LIBS ON

# 查找Qt5的必要组件，这里你用到了Widgets、Gui、Core，必须明确指定
find_package(Qt5 REQUIRED COMPONENTS Widgets Gui Core)

# 设置C++标准，这里用C++17更现代，如果你坚持用C++14也可以改成14
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 保留你需要的警告编译选项，但别在这里加链接库！
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wpedantic -Wextra -no-pie -fPIC")
# 静态链接的关键：把-static放到链接器选项里，让整个程序尽量静态依赖
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static")

# 开启Qt的自动工具链：处理元对象编译(MOC)、UI文件编译(UIC)、资源文件编译(RCC)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)

# 替换成你实际的源文件、头文件、UI文件列表
set(SOURCES
    main.cpp
    calculator.cpp
)

set(HEADERS
    calculator.h
)

set(UIS
    calculator.ui
)

# 添加可执行文件目标
add_executable(Calculator ${SOURCES} ${HEADERS} ${UIS})

# 正确链接Qt库：CMake会自动处理静态库的依赖路径和顺序，比手动加-l靠谱多了
target_link_libraries(Calculator PRIVATE Qt5::Widgets Qt5::Gui Qt5::Core)

还有几个必须注意的关键点，不然配置对了也可能跑不起来：

你必须有静态编译的Qt版本：默认安装的Qt都是动态库版本，你得自己重新编译Qt的静态库。编译时要加上-static配置选项，还要注意把平台插件（比如Windows的qwindows、Linux的xcb）也编译成静态版本，这样才能把插件打包进exe里。
Windows平台额外配置：如果是在Windows上编译，要确保静态链接VC++运行时库，在CMake里加一行：set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")，避免目标电脑缺少VC运行时。
测试验证：编译完后，把生成的exe单独复制到学校电脑上运行，如果还是提示缺少dll，说明还有动态依赖没处理干净——要么是Qt没真的静态编译，要么是漏了某个系统库的静态链接。

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