重复定义错误源于头文件被多次包含导致多个翻译单元生成同名符号，解决方法是用extern分离声明与定义，或使用C++17 inline变量/函数。
重复定义错误通常出现在头文件被多次包含时
这是 C++ 里最常见也最容易被误判为“链接错误”的编译阶段问题。根本原因不是你写了两遍 int x = 42;，而是多个翻译单元（.cpp 文件）通过头文件间接包含了同一个变量或函数的**定义**，导致链接器看到多个同名符号。
典型现象是：编译能过，但链接时报错类似 multiple definition of 'foo' 或 duplicate symbol _bar in xxx.o and yyy.o。
- 全局变量在头文件里直接初始化（如
int global_val = 10;）→ 必然重复定义 - 内联函数没加
inline且定义在头文件中 → 每个 .cpp 包含它就生成一份实体 - 模板显式特化写在头文件里又没用
extern template声明 → 多次实例化 - 使用了
#include但没加 include guard 或#pragma once→ 头文件内容被展开多次
用 extern + 分离声明与定义是最稳妥的做法
对非 const 全局变量、非 inline 函数，必须把声明和定义拆开：声明放头文件，定义放一个且仅一个 .cpp 文件里。
比如你想共享一个计数器：
立即学习“C++免费学习笔记（深入）”；
// counter.h #ifndef COUNTER_H #define COUNTER_H extern int g_counter; // 声明：告诉所有人“这个变量存在”，但不分配内存 void increment(); #endif
// counter.cpp
#include "counter.h"
int g_counter = 0; // 定义：只在这里分配内存并初始化
void increment() { ++g_counter; }其他所有 .cpp 只需 #include "counter.h" 就能用 g_counter 和 increment()，不会触发重复定义。
-
extern关键字在头文件中是必须的，否则int g_counter = 0;就是定义 - const 全局变量默认有内部链接（
static语义），所以const int kMax = 100;放头文件里一般没事 - 但
constexpr变量在 C++17 前也默认内部链接；C++17 起若未加inline，仍可能出问题
inline 变量（C++17）和 inline 函数可安全放在头文件里
C++17 引入 inline 变量，让头文件定义变得合法且无冲突。它告诉编译器：“这个定义可能出现多次，但请只保留一份”。适用于常量、工具函数、静态数据成员等。
// utils.h
#ifndef UTILS_H
#define UTILS_H
inline constexpr int kBufferSize = 4096; // OK：constexpr + inline
inline std::string get_app_name() { return "app"; } // OK：inline 函数
inline int g_config_flag = 1; // OK：C++17 inline 变量
#endif注意：inline 不代表“建议内联”，而是一种链接属性。没有 inline 的函数即使写在头文件里，也会因 ODR 违反被拒绝。
- 旧代码迁移到 C++17 后，把头文件里的
static const换成inline constexpr更清晰 - 类内定义的
static constexpr成员自动是inline（C++17 起），无需额外修饰 - 但
inline不能解决非 constexpr 的非常量变量的初始化顺序问题——这点容易被忽略
模板和内联函数必须完整定义在头文件里，但要注意显式实例化控制
模板本身不是代码，只有被实例化时才生成具体函数/类。所以模板声明和定义通常都在头文件里——但这不等于“可以随便写”。问题常出在显式特化或显式实例化上。
例如：
// bad: 在头文件里做显式特化
template<> void process<int>(int x) { /* ... */ } // 每个包含它的 .cpp 都会生成一份正确做法是：声明放头文件，定义放单个 .cpp，并用 extern template 阻止其他地方实例化：
// processor.h template<typename T> void process(T); extern template void process<int>(int); // 告诉编译器：int 版本在外面定义
// processor.cpp
#include "processor.h"
template<typename T> void process(T t) { /* generic impl */ }
template void process<int>(int); // 显式实例化：只在这里生成- 不加
extern template声明，编译器会在每个 .cpp 里尝试实例化模板，导致重复 - 类模板的成员函数即使没显式特化，只要被调用，就会在每个 TU 中隐式实例化——所以尽量保持模板实现短小
- 函数模板加
inline没意义，它本身就不受 ODR 限制；但显式特化必须按普通函数处理
真正麻烦的不是语法规则，而是混合使用旧习惯（比如在头文件里写 static int x = 0;）和新特性（inline）时，链接行为会悄无声息地变化。尤其在跨平台构建或升级编译器版本后，原本“碰巧能过”的代码可能突然报错。盯住 multiple definition 提示里的符号名，顺藤摸到它第一次被定义的位置，比猜更可靠。
