MSYS2中Clang编译GUI程序WinMain入口未生效问题

我正在跟随《Handmade Hero》系列教程，使用MSYS2中的Clang编译器搭建测试程序，却无法让程序以WinMain作为入口点。

测试代码如下：

#include <windows.h>

int main(int argc, char **argv)
{
    OutputDebugStringA(TEXT("hello console"));
    return 0;
}
    
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) 
{
    OutputDebugStringA(TEXT("hello windows"));
}

CodeLite执行的编译、链接命令如下：

C:/msys64/clang64/bin/clang++.exe  -c  "D:/Handmade/Handmade/main.cpp" -gdwarf-2 -fstandalone-debug -O0 -Wall   -o ../build-Debug/Handmade/main.cpp.o -IC:\msys64\clang64\include\c++\v1 -IC:\msys64\clang64\lib\clang\16\include -IC:\msys64\clang64\include  -I. -I.

C:/msys64/clang64/bin/clang++.exe -o ..\build-Debug\bin\Handmade.exe @../build-Debug/Handmade/ObjectsList.txt -L. -luser32 -Wl,-subsystem,windows

代码编译无错误，但DebugView显示"hello console"，说明WinMain未被作为入口点调用。原本以为添加-Wl,-subsystem,windows链接标志会启用GUI子系统，但并未生效，请问是否遗漏了其他链接标志？

• 问题根源：MSYS2 clang64环境下的Clang默认链接的C/C++运行时启动代码，会优先检测main函数是否存在——只要代码里有main，即便指定了-subsystem,windows，启动代码依然会调用main而非WinMain。

• 解决办法1：移除main函数
  直接删除代码中的main函数，链接器在找不到main的情况下，会自动适配GUI子系统的入口规则，寻找WinMain作为程序入口。

• 解决办法2：强制指定入口点
  在链接命令中添加-Wl,-e,_WinMain@16标志（WINAPI是stdcall调用约定，函数会被修饰为_WinMain@16），强制让链接器将WinMain设为入口点。修改后的链接命令如下：

  C:/msys64/clang64/bin/clang++.exe -o ..\build-Debug\bin\Handmade.exe @../build-Debug/Handmade/ObjectsList.txt -L. -luser32 -Wl,-subsystem,windows,-e,_WinMain@16
  

• 补充说明：
  如果不需要保留控制台入口逻辑，删除main是最简洁的方案；如果必须保留main同时启用WinMain入口，使用强制指定入口点的方法更合适。MSYS2其他环境（如mingw64）的行为可能略有不同，但clang64环境下上述两种方法均可解决问题。

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