定义指编译器会分配内存或生成代码实体的写法，如int g=0;、void f(){}、类内成员函数实现、非整型const变量等；声明如extern int g;、函数声明、前置声明等则安全。
头文件里只要出现“定义”，就容易重复定义——声明没事，定义危险。
哪些内容算“定义”？
编译器看到以下写法，就会为它分配内存或生成代码实体，一旦头文件被多个 .cpp 包含，就触发 ODR（单定义规则）违规：
-
int g_counter = 0;—— 全局变量带初始化就是定义（extern int g_counter;是声明） -
void helper() { ... }—— 普通函数实现（非inline、非模板） -
class Widget { void run() { ... } };—— 成员函数在类体内定义，等效于 inline，但若类被多次包含且未加防护，仍可能引发冲突（尤其涉及静态成员） -
const std::string kName = "test";—— 非整型const变量不默认内部链接，C++17 前有风险；C++17 起推荐用inline const std::string kName = "test"; -
template struct MyTrait<int>;</int>—— 显式特化若没配合extern template声明，每个包含它的.cpp都会实例化一份
哪些内容是安全的（只声明，不定义）？
这些可以放心放在头文件里，重复包含也不会报错：
-
extern int g_counter;—— 声明不分配内存 -
void do_work(int x);—— 函数声明 -
class Widget;—— 前置声明（不展开定义） -
struct Point { int x, y; };—— 类/结构体定义本身允许重复（ODR 允许），但前提是内容完全一致；若分散在多个头文件中微调过，就变成“ODR 违规”，报错更隐蔽 -
#define MAX_SIZE 1024或using Vec = std::vector<int>;</int>—— 宏和类型别名不产生符号，无链接问题
为什么 const int kMax = 100; 有时不报错？
因为整型 const 变量默认具有内部链接（static 语义），每个 .cpp 翻译单元都得到自己的副本，不参与链接。但这只是“碰巧不炸”，不是设计意图：
- 换成
const std::string s = "hello";就大概率出问题（外部链接） - 换成
constexpr int v = 42;在 C++17 前也安全，但 C++17 起若没加inline，仍可能在某些场景下违反 ODR - 靠“类型是否整型”来判断安全性，属于魔法依赖，工程中应统一用
inline constexpr或extern + .cpp 定义
最容易被忽略的坑：头文件没加防护，但暂时没报错
有些头文件只含声明和类定义，当前没报错，不代表安全：
- 某天你加了一行
static constexpr double PI = 3.14159;—— 看似 harmless，但若该头被间接包含多次，而项目又开了 LTO 或某些链接模型，可能触发 ODR 报警 - 第三方库头文件没加
#pragma once或 include guard，你直接#include它，再被其他头文件转引，就埋下循环包含或深度嵌套隐患 -
#include "xxx.h"写在.cpp里没问题，但写在另一个.h里，就立刻把依赖关系扩散出去，失控只差一步
防护机制不是可选项，是头文件的出厂设置。哪怕今天只有 class A {};，第一行也该是 #pragma once 或标准 include guard。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
