undefined reference to 'main'错误表明链接器未找到标准入口函数，根本原因是程序缺少int main(int, char**)或等价签名的定义；常见情形包括未编写main函数、拼写错误（如mian/main）、使用winmain但未配-mwindows选项、文件bom干扰或c++语法误用gcc编译。
undefined reference to 'main' 是入口函数缺失或不匹配
这个错误不是编译失败，而是链接器找不到程序起点。GCC 默认要求一个名为 main 的函数（签名必须是 int main(int, char**) 或等价形式），否则拒绝生成可执行文件。
常见诱因包括：
- 源文件里压根没写
main函数（只写了foo()、test()等） - 写了
_tmain、wmain或WinMain，但没加对应编译选项（如-municode或-mwindows） - 文件编码或 BOM 导致
main函数名被破坏（尤其 Windows 上用记事本保存的 .c 文件） - 用了 C++ 语法写 C 文件，又用
gcc编译，导致 name mangling 干扰符号识别
快速验证：运行 nm -C *.o | grep "main"，看输出中是否有 T main（T 表示已定义的文本段符号）。没有就说明 main 没被正确编译进去。
undefined reference to 'xxx' 说明符号定义没进链接流程
报错里 xxx 是某个函数或变量名，意味着编译器在某个 .o 文件里看到了对它的调用（U xxx），但翻遍所有输入的目标文件和库，都没找到 T xxx 或 D xxx 的定义。
最常踩的坑有三个：
-
漏文件：比如
main.c调了calc_sum()，但编译命令只写了gcc main.c -o app，没把实现calc_sum()的util.c加进去 -
顺序错：用
gcc main.o -lmylib，而mylib.a依赖更底层的libcutils.a，但没写在后面——链接器从左到右扫描，遇到未解析符号才往右找，不会回溯 -
声明/定义不一致：头文件里声明
void log(const char*, int)，实现文件里写成void log(char*, int)（少了个const），C++ 下还会因类型差异产生不同符号名
查证手段：nm -C main.o | grep log 看是否为 U；再 nm -C libutil.a | grep log 看是否存在且签名匹配。
链接时加了 -l 但 still undefined reference
-lxxx 不是万能钥匙。它只告诉链接器“去标准路径或 -L 指定路径下找 libxxx.a 或 libxxx.so”，但不保证里面真有你要的符号。
典型问题：
- 静态库
libxxx.a是用ar打包的多个.o，但其中没包含定义xxx的那个目标文件 - 库是为其他架构编译的（比如 x86_64 库给 i386 项目用），
file libxxx.a可确认 - 用了
-shared编译的动态库，但没导出符号（缺少__attribute__((visibility("default")))或链接脚本控制） - 库依赖另一层库，而你没连那一层（例如
libcurl依赖libssl和libcrypto，只链-lcurl不够）
可靠做法：gcc main.o -L./libs -lxxx -lxxx-dep -o app，把依赖链从底向上列全；或者先用 objdump -t libxxx.a | grep xxx 确认符号存在。
Windows 下 MinGW 报 WinMain@16 错误
这是 MinGW 特有的子系统陷阱。当你没显式指定子系统，GCC 会根据入口函数名自动选：看到 WinMain 就用 Windows GUI 子系统（-mwindows），看到 main 就用 Console 子系统（-mconsole）。但如果你的代码只有 main，却因某些原因（比如工程模板、IDE 默认设置、或链接了 Windows GUI 库）让链接器按 WinMain 去找，就会崩。
解法直截了当：
- 确保源码里有且仅有一个标准
int main(int argc, char *argv[]) - 编译时强制指定子系统：
gcc a.c -mconsole -o a.exe - 如果真要写 GUI 程序，就改用
int WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int)并加-mwindows - 避免混用
g++和gcc编译同一项目——C++ 运行时可能悄悄注入WinMain入口逻辑
最容易被忽略的是：哪怕你改了代码，PowerShell 命令里反复执行的旧命令（比如你知识库中那个 gcc a -o ...）仍会复现旧错误。删掉旧 a.exe 和 a.o，重新完整构建一次。
