VS Code运行C语言Hello World报错：undefined reference to WinMain

安全阿岳

2026-8-22

解决VS Code中GCC编译C代码出现undefined reference to 'WinMain'的问题

这个错误的核心原因是MinGW链接器误将你的程序识别为Windows GUI程序——GUI程序的入口函数是WinMain，但你的代码里只有标准控制台程序的入口main，所以链接器找不到对应入口就报错了。以下是具体解决方法：

方法一：手动终端编译测试（先排除VS Code配置问题）

打开VS Code终端，进入代码所在目录，执行编译命令：

gcc 你的代码文件名.c -o 输出文件名.exe

比如你的代码是hello.c，就执行：

gcc hello.c -o hello.exe

如果编译成功且能正常运行hello.exe，说明问题出在VS Code的任务配置上，直接看方法二。

方法二：修改VS Code的tasks.json配置

按Ctrl+Shift+B打开任务面板，选择“创建tasks.json文件”（已有配置的话直接打开）。
确保编译命令用gcc而非g++，并在参数中添加-mconsole，明确指定生成控制台程序。修改后的示例配置如下：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: gcc.exe 生成活动文件",
            "command": "C:/Users/aathi/Msys2/mingw64/bin/gcc.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe",
                "-mconsole" // 关键参数：强制生成控制台程序
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": ["$gcc"],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "编译器: C:/Users/aathi/Msys2/mingw64/bin/gcc.exe"
        }
    ]
}