操作系统只认一个main入口，链接器合并目标文件时仅保留一个main地址填入程序头；多个main导致duplicate symbol错误，void main()虽可编译但不被crt识别，真正入口是maincrtstartup调用的main；应将逻辑拆至run_app()函数供main调用及测试。
链接器找不到第二个入口点，不是“不允许”，而是“没地方放”
操作系统加载可执行文件时，只认一个固定符号名：main。链接器在合并所有 .o 文件时，会把所有定义了 main 的目标文件里的符号统一收拢，最终只保留一个地址填进程序头的“入口偏移”字段。如果两个 .cpp 文件都写了 int main() { return 0; }，链接阶段就会报错：duplicate symbol 'main' in main.o and utils.o——这不是语法限制，是二进制格式层面的硬约束。
void main() 能编译过，但不代表它被当作入口
某些旧版编译器（如早期 MSVC）允许 void main()，但它不会被写入标准入口表；运行时可能跳过栈初始化、C 运行时（CRT）未就绪，导致 std::cout 崩溃或全局对象不构造。真正起作用的仍是那个被 CRT 封装过的 main 入口包装函数（比如 mainCRTStartup），它最后才调用你写的 main。所以即使 void main() 看似跑通，也只是侥幸绕过了部分检查，跨平台构建必失败。
想复用逻辑？别动 main，拆出 run_app() 函数
多人协作或模块化开发时，常有人想“多个 main 分别测试不同分支”。这不可行，但可以：
- 把实际业务逻辑全移到
int run_app(int argc, char* argv[])里 - 在主
main中直接调用它：return run_app(argc, argv); - 单元测试时，直接链接并调用
run_app，完全绕过main生命周期
嵌入式或 freestanding 环境下，main 都不一定存在
标准 C++ 的 main 是 hosted 环境（有操作系统、有 CRT）的约定。但在裸机（freestanding）环境（如 STM32 固件、bootloader）中，入口可能是 _start 或 Reset_Handler，连 argc/argv 都没有。这时候你写的 main 只是被启动代码调用的一个普通函数，甚至可以有多个——但那已不属于“C++ 程序入口”的讨论范畴。日常开发中，只要用 g++ 或 clang++ 编译可执行文件，默认就是 hosted 模式，main 的唯一性不可妥协。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
