编译基础C代码报collect2.exe: error: ld returned 1 exit status如何解决

该报错属于MinGW GCC链接阶段错误，核心根因为链接器未找到有效程序入口函数，尝试查找Windows GUI程序默认入口WinMain@16失败，常见触发场景如下：

• 编译时指定了GUI子系统参数：若编译命令中携带-mwindows参数，链接器会默认将程序入口设置为GUI程序使用的WinMain，而非控制台程序的main函数，匹配失败就会抛出该错误。
• 上一次编译生成的exe仍在运行：Windows系统会锁定运行中的可执行文件，编译器无法覆盖写入新的exe文件，部分场景下也会触发该链接错误，是新手编译Hello World类程序时最常遇到的触发原因。
• 代码或编译路径错误：编译的源文件未正确保存、文件中main函数拼写错误，或编译命令指定的源文件路径错误，都会导致链接器找不到main函数入口。
• MinGW环境异常：极小概率是MinGW的运行库文件损坏或环境变量配置错误，导致链接器默认优先匹配GUI入口。

按优先级从高到低依次尝试即可：

• 结束残留运行进程：打开任务管理器，找到和编译输出同名的exe进程，结束进程后重新执行编译命令。
• 修正编译参数：去掉编译命令中的-mwindows参数，也可以主动添加-mconsole参数强制指定控制台子系统，明确要求链接器使用main作为入口，示例编译命令：gcc 你的源文件名.c -o 输出程序名.exe -mconsole
• 校验代码和路径：确认要编译的源文件已正确保存，main函数拼写无误，编译命令中指定的源文件路径正确。
• 修复MinGW环境：上述方案均无效时，卸载现有MinGW后重新下载官方稳定版本安装即可。

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