已解决：Windows10下VSCode安装MinGW编译C++报错问题

undefined reference to 'WinMain'属于C链接阶段错误，和MinGW环境识别、g本身安装完整性无关，静态代码检查无法扫描到这类链接阶段问题，因此之前错误检测无提示是正常现象。该错误核心触发逻辑是g完成编译后进入链接阶段时，找不到匹配的程序入口函数，连带导致VSCode调试时出现g异常退出、无法生成可执行文件的现象。

• 校验源码入口正确性
  控制台C++程序的标准入口为int main()或int main(int argc, char* argv[])，需确认：
  • main函数拼写、返回值类型无错误
  • main函数未被包裹在自定义命名空间内
  • main函数未被条件编译宏排除
    若开发Windows GUI程序需使用WinMain作为入口，控制台程序编译时不可添加-mwindows链接参数。
• 校验命令行编译参数
  手动执行g++编译时必须把所有包含业务逻辑、包含入口函数的.cpp源文件完整写入命令，漏加写有main函数的源文件是该错误最高频触发原因。正确编译示例：

  g++ main.cpp func.cpp -o app.exe
  

  仅执行g++ -o app.exe这类未传入源文件的命令时，g++会默认查找GUI程序入口WinMain，直接触发该报错。
• 校验VSCode编译配置
  打开项目目录下.vscode/tasks.json文件，检查args字段配置：
  • 必须包含"${file}"（当前打开的源文件）或所有项目源文件的完整路径，不可漏传
  • 控制台程序不要添加-mwindows参数
    标准控制台程序编译的args配置参考：

  "args": [
    "-g",
    "${file}",
    "-o",
    "${fileDirname}\\${fileBasenameNoExtension}.exe"
  ]
  

• 校验源文件后缀
  包含main函数的代码必须写在.cpp/.cc后缀的源文件中，不可写在.h头文件内，头文件不会被g++作为独立编译单元参与链接，会导致入口丢失。
• 清理编译缓存
  删除项目目录下所有之前生成的.o目标文件、损坏的可执行文件，避免旧的错误编译结果干扰新的编译流程。

完成上述调整后，先在命令提示符中切到项目目录，执行完整的g编译命令，确认可以正常生成exe文件后，再回到VSCode启动调试即可，此前的g退出码-1、无法生成可执行文件问题会同步解决。

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