QT5 隐藏控制台窗口方法2025.6.12

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

---

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

步骤1：修改项目属性

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

     /SUBSYSTEM:WINDOWS
     

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

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

#include 
#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 
#include 
#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 
#include 
#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版本使用方案二。