Clang报multiple definition of 'xxx'是链接阶段错误，因同一符号在多个目标文件中被定义，违反ODR规则；常见原因是头文件中含带初始化的变量定义、函数实现未加inline或缺失头文件保护宏。
Clang 报 multiple definition of 'xxx'，说明链接阶段发现同一个符号在多个目标文件里被定义了——不是语法错，是链接规则被违反了。C/C++ 要求全局变量或函数只能有一个定义（ODR），Clang 比 GCC 更严格，尤其在启用 -Wall -Werror 时会直接中断构建。
头文件里写了 int x = 1; 就完蛋了
这是最常见也最容易忽略的源头。只要你在 .h 文件里写了带初始化的变量定义（比如 int debug_flag = 0;），而这个头被两个以上 .c 文件包含，每个 .c 编译出的 .o 都会自带一份 debug_flag 的定义，链接时必然冲突。
- ✅ 正确做法：头文件只放
extern int debug_flag;，真正定义（int debug_flag = 0;）挪到且仅挪到一个.c文件里 - ⚠️ 注意：
const int version = 1;在 C 里不算“常量表达式”，仍会触发多重定义；C++ 中const有内部链接属性，但 Clang 默认按 C 标准处理 C 文件 - ❌ 不要试图用
static int x = 1;塞进头文件——这会让每个包含它的.c都生成一份私有副本，虽不报错但语义错误（你本意是共享变量）
函数实现在头文件里，没加 inline
如果你把函数体直接写在 .h 里（比如 void log_msg(char* s) { printf("%s\n", s); }），又在多个 .c 中 #include 它，Clang 会在每个编译单元生成一份函数代码，链接时报 multiple definition of 'log_msg'。
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- ✅ 推荐方案：函数声明放
.h，实现放唯一.c文件 - ✅ 小函数可加
inline：inline void log_msg(char* s) { ... }—— Clang 支持 C99 的inline，且不会因未内联而留多个定义 - ⚠️ 注意：
static inline也可以，但它让函数彻底变成各编译单元私有，无法跨文件调用；除非你明确需要隔离行为，否则别用
忘了加头文件保护宏，嵌套包含炸了
没有 #ifndef XXX_H / #define XXX_H / #endif 的头文件，一旦被间接多次包含（比如 A.h 包含 B.h，B.h 又包含 A.h），预处理器就会把同一段内容复制粘贴好几遍，变量/函数声明可能重复，定义更会翻倍。
立即学习“C语言免费学习笔记（深入）”；
- ✅ 所有
.h文件顶部必须加标准保护宏，名字用大写+下划线+文件名（如#ifndef UTILS_H） - ✅ Clang 支持
#pragma once，效果等价且更简洁，但某些旧项目或跨平台构建系统可能不兼容，优先用传统宏 - ⚠️ 检查方式：运行
clang -E file.c | grep "your_var_name"，看预处理后该变量出现几次
Clang 的错误提示里通常会附带 first defined here 行号，那是第一个定义的位置——但别只修那里，得通查所有包含该头的源文件，确认定义是否真的唯一。最麻烦的是第三方头文件偷偷定义了变量，这时只能用 extern 声明覆盖，或改用静态库链接隔离符号。
