如何将Windows GUI程序入口从WinMain改为main或自定义函数？

我来给你理清楚怎么实现这个需求——把Windows GUI程序的默认入口WinMain换成像Qt那样的int main(int argc, char *argv[])，而且要兼容MSVC、GCC、Clang这几个主流编译器。其实核心思路就是要么让编译器/链接器帮我们做入口适配，要么自己写一层转发代码，两种方法都可行，下面分别说明：

方法一：利用CRT的入口适配（无需额外转发代码） #

Windows的CRT（C运行时库）其实已经内置了入口适配逻辑：

• 控制台程序默认入口是mainCRTStartup，它会解析命令行参数，然后调用我们写的main
• GUI程序默认入口是WinMainCRTStartup，它会调用我们写的WinMain

我们只需要告诉链接器：虽然是GUI程序，但我们要用mainCRTStartup作为入口，这样CRT就会自动把命令行转成argc/argv，然后调用我们的main函数。

针对不同编译器的配置 #

• MSVC：
  在项目属性里设置：
  1. 链接器 -> 系统 -> 子系统：选择Windows (/SUBSYSTEM:WINDOWS)
  2. 链接器 -> 高级 -> 入口点：填写mainCRTStartup
     或者直接在编译命令里加链接选项：

  cl your_code.cpp /SUBSYSTEM:WINDOWS /ENTRY:mainCRTStartup
  

• GCC/Clang（MinGW环境）：
  编译时指定GUI子系统和入口点：

  g++ your_code.cpp -mwindows -Wl,-e,_mainCRTStartup -o your_app.exe
  

  （MinGW下函数名会带下划线前缀，所以用_mainCRTStartup）

示例代码 #

直接写标准的main函数即可，和控制台程序一样，然后在里面写GUI逻辑：

#include <windows.h>

int main(int argc, char* argv[]) {
    // 打印参数（如果需要调试，可临时加AllocConsole()调出控制台窗口）
    for (int i = 0; i < argc; i++) {
        MessageBoxA(NULL, argv[i], "Argument", MB_OK);
    }
    // 这里写你的GUI初始化代码，比如创建窗口、消息循环等
    MessageBoxA(NULL, "Hello from custom main!", "Success", MB_OK);
    return 0;
}

方法二：自定义转发层（兼容性更强，类似Qt/MFC的封装） #

如果不想修改链接器选项，我们可以自己写一个WinMain作为系统的入口点，然后在里面把Windows的命令行参数转换成argc/argv，再调用我们自定义的main函数。这种方法不需要调整编译器设置，所有编译器都能直接兼容。

转发层代码 #

#include <windows.h>
#include <stdlib.h>

// 声明我们的自定义入口函数
int main(int argc, char* argv[]);

// 系统调用的WinMain，作为转发中间层
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd) {
    // 调用Windows API把命令行字符串解析成argc/argv
    int argc;
    char** argv = CommandLineToArgvA(GetCommandLineA(), &argc);
    if (!argv) {
        return 1; // 解析失败直接退出
    }

    // 调用我们的自定义main函数
    int ret_code = main(argc, argv);

    // 释放API分配的内存
    LocalFree(argv);
    return ret_code;
}

// MSVC需要手动链接shell32.lib（CommandLineToArgvA依赖）
#ifdef _MSC_VER
#pragma comment(lib, "shell32.lib")
#endif

使用方法 #

把上面的代码和你的业务代码放在一起编译即可，不需要额外的链接器选项：

• MSVC：直接编译，子系统默认会自动识别为GUI（因为有WinMain），或者手动指定/SUBSYSTEM:WINDOWS
• GCC/Clang（MinGW）：用-mwindows编译，避免弹出控制台窗口：

  g++ your_code.cpp forward_layer.cpp -mwindows -o your_app.exe
  

示例业务代码 #

同样直接写标准main函数：

#include <windows.h>

int main(int argc, char* argv[]) {
    // 注册窗口类
    WNDCLASSEXA wc = {0};
    wc.lpfnWndProc = DefWindowProcA;
    wc.hInstance = GetModuleHandle(NULL);
    wc.lpszClassName = "CustomMainWindowClass";
    RegisterClassExA(&wc);

    // 创建窗口
    HWND hwnd = CreateWindowA("CustomMainWindowClass", "Custom Main Entry", WS_OVERLAPPEDWINDOW | WS_VISIBLE,
                              CW_USEDEFAULT, CW_USEDEFAULT, 400, 300, NULL, NULL, GetModuleHandle(NULL), NULL);
    
    // 消息循环
    MSG msg;
    while (GetMessage(&msg, NULL, 0, 0)) {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    return msg.wParam;
}

为什么MFC/Qt能做到？ #

其实它们的核心逻辑和上面的方法二一致：

• MFC把WinMain封装在CRT库中，然后调用CWinApp的InitInstance方法作为业务入口
• Qt则自己实现了入口转发逻辑，把系统的WinMain（或wWinMain）转换成int main(int argc, char** argv)，然后让开发者基于这个入口写代码

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