Clang报multiple definition错误主因是头文件中误放定义，应将变量和函数实现移至源文件，头文件仅保留extern声明和函数原型，并添加唯一头文件保护宏。
Clang 编译多个文件报 multiple definition，基本不是 Clang 本身的问题，而是你把定义放进了头文件、或没控制好链接范围——它只是比 GCC 更早、更严格地暴露了 C/C++ 的链接规则。
头文件里写了变量或函数实现？立刻删掉
这是最常见也最容易被忽略的根源。比如你在 utils.h 里写了：
int counter = 0;
void log_message() { printf("hello\n"); }
只要两个 .c 或 .cpp 文件都 #include "utils.h"，Clang 在链接阶段就会报 multiple definition of 'counter' 和 multiple definition of 'log_message'。
- 头文件只做声明：变量加
extern，函数只写原型 - 所有定义（带初始化的变量、函数体）必须挪到对应的
.c或.cpp文件里 - 哪怕函数只有 1 行，也不要在头文件里直接写实现，除非加
inline（C++）或static inline（C99+）
没加头文件保护宏？马上补上
即使头文件里全是声明，如果没加保护宏，嵌套包含时仍可能触发重复展开，间接导致某些宏展开后意外产生定义（比如宏里带 static int x;）。Clang 对这类边界情况更敏感。
- 每个头文件开头结尾必须是：
#ifndef MY_HEADER_H→#define MY_HEADER_H→#endif - 宏名要唯一，推荐用全大写 + 下划线 + 文件名（如
UTILS_H），避免用__UTILS_H__这类双下划线（保留给编译器） - 别依赖
#pragma once—— 它不是标准，Clang 虽支持，但跨平台项目中仍有风险
多个源文件都定义了同一个 main？确认评测/构建目标
在头歌等教学平台或 Clion 等 IDE 中，multiple definition of 'main' 往往不是代码问题，而是构建配置错误。
- 检查是否多个
.c文件都写了int main()，而构建系统试图把它们全链接进一个可执行文件 - 头歌平台要求：同一关卡（如
step2/）下，仅允许“评测执行文件”含main，其余.c文件不能有 - 本地用 Clang 手动编译时，不要写
clang main1.c main2.c -o app；应分步编译再链接，或明确指定哪个是入口：clang -c main1.c -o main1.o && clang -c utils.c -o utils.o && clang main1.o utils.o -o app
用了 static 却还报重定义？检查作用域混淆
static 能解决重复定义，但只对**同一编译单元内**有效。如果你误以为它能跨文件去重，就容易踩坑。
-
static int x = 1;写在头文件里 → 每个#include它的.c都生成一份独立的x，不冲突，但也不是你想要的“全局唯一” -
static函数不能被其他文件调用，如果其他文件通过头文件声明了它，链接时会报undefined reference，而不是multiple definition - 真正想共享变量？用
extern声明 + 单一.c定义；想限制作用域？static放在.c文件顶部，别放头文件
Clang 的报错信息通常会标出“first defined here”，顺着这个提示看哪两个文件同时定义了同一个符号，比猜原因快得多。真正的难点不在语法，而在理解“每个 .c 是一个编译单元，定义只允许出现一次，声明可以无数次”——这个规则，Clang 从不妥协。
