QT5 隐藏控制台窗口方法2025.6.12

在VS2015+Qt5.12环境下隐藏控制台窗口并直接运行上位机UI，可通过以下两种方案实现：

---

方案一：修改子系统为Windows（推荐）

步骤1：修改项目属性

1. 右键项目 → 属性 → 配置属性 → 链接器 → 系统
   • 将 子系统(Subsystem) 改为：

     /SUBSYSTEM:WINDOWS
     

2. 配置属性 → 链接器 → 高级
   • 确保 入口点(Entry Point) 为空（默认自动匹配）

步骤2：实现标准Qt入口点

#include <QtWidgets/QApplication>
#include "mainwindow.h"// 使用 WINAPI 宏匹配 __stdcall 调用约定
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE, LPSTR, int nCmdShow) {QApplication a(argc, argv);  // Qt会自动处理命令行参数MainWindow w;w.show();return a.exec();
}

步骤3：处理Qt特殊依赖

在.pro文件中添加（或确保存在）：

QT += widgets
CONFIG += c++11

---

方案二：保留控制台子系统但隐藏窗口

方法1：通过代码隐藏控制台

#include <windows.h>
#include <QtWidgets/QApplication>
#include "mainwindow.h"int main(int argc, char *argv[]) {// 隐藏控制台窗口（必须在QApplication初始化前调用）::ShowWindow(::GetConsoleWindow(), SW_HIDE);// 或强制释放控制台// FreeConsole();QApplication a(argc, argv);MainWindow w;w.show();return a.exec();
}

方法2：修改入口点（需处理Qt初始化）

1. 项目属性 → 链接器 → 高级
   • 设置 入口点(Entry Point) 为：

     mainCRTStartup
     

2. 保持子系统为控制台，但使用自定义入口：

#include <windows.h>
#include <QtWidgets/QApplication>
#include "mainwindow.h"// 自定义入口点
extern "C" int mainCRTStartup(void) {// 隐藏控制台::ShowWindow(::GetConsoleWindow(), SW_HIDE);// 手动初始化Qt（需处理argc/argv）int argc = 0;char* argv[] = { nullptr };QApplication a(argc, argv);MainWindow w;w.show();return a.exec();
}

---

关键注意事项

1. Qt初始化顺序：

   • 必须在QApplication初始化前隐藏控制台，否则窗口可能短暂闪现
   • 方案二方法2需要手动管理argc/argv参数

2. 调试模式：

   • 开发阶段可保留控制台输出，通过预处理器指令控制：

     #ifndef _DEBUG
     ::ShowWindow(::GetConsoleWindow(), SW_HIDE);
     #endif
     

3. 资源文件依赖：

   • 确保Qt的DLL（如Qt5Core.dll、Qt5Widgets.dll）已正确部署
   • 使用Windeployqt工具自动拷贝依赖：

     windeployqt.exe --release your_app.exe
     

4. Unicode设置：

   • 项目属性 → 高级 → 字符集 → 使用Unicode字符集
   • 入口函数需使用宽字符版本：

     int WINAPI wWinMain(HINSTANCE, HINSTANCE, LPWSTR, int) { ... }
     

---

方案对比

方案	优点	缺点
方案一	完全无控制台残留，符合Windows程序规范	需修改入口点，需处理Qt初始化
方案二	保留控制台调试能力，快速实现	残留控制台进程，可能影响资源释放

建议优先选择方案一，若需保留控制台调试能力，可在Release版本使用方案一，Debug版本使用方案二。