inline变量解决链接时LNK2005或multiple definition错误，允许头文件中安全定义全局变量；需同时满足：声明定义均含inline、必须初始化、仅限头文件中定义。
inline 变量解决的是什么问题
链接时出现 LNK2005（MSVC）或 multiple definition of 'xxx'（GCC/Clang），根本原因是：全局变量在多个 .cpp 文件里被包含头文件后重复定义。以前靠 extern 声明 + 单独定义来绕，现在 C++17 起，inline 变量直接让头文件里定义“合法且安全”。
怎么写才不会报错
必须同时满足三个条件，缺一不可：
-
inline关键字必须出现在变量声明和定义处（不能只写在头文件声明里、源文件再定义） - 变量必须有初始化器（
=或{}），不能是未初始化的inline int x; - 只能在头文件中定义（不能在
.cpp里写inline变量——它就失去意义了）
正确示例：
// config.h
inline const int MAX_RETRY = 3;
inline std::string app_name = "myapp";
inline const std::vector<int> DEFAULT_IDS{1, 2, 3};为什么 static 数据成员不行
类内 static 成员变量虽然也能放头文件，但有硬伤：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- 非
const整型以外的类型，仍需在.cpp中定义一次（否则链接失败） - 模板类里的
static成员，每个实例化都会生成一份，无法共享同一地址 - 无法用于命名空间作用域的普通变量（比如你想导出一个全局配置常量）
inline 变量没有这些限制——所有 TU（翻译单元）看到的是同一个实体，地址一致，初始化只发生一次。
容易被忽略的坑
几个实际踩过的点：
-
inline不等于“编译器会内联”，它只是链接属性；变量本身还是存在内存里的 - 如果变量类型含非平凡构造函数（比如
std::string），多个 TU 中初始化顺序不确定——别依赖跨inline变量的初始化时序 - 旧项目升级到 C++17 后加
inline，但构建系统没设-std=c++17，GCC/Clang 会直接报error: 'inline' can only be used on variables with internal linkage before C++17 - MSVC 在 /permissive- 模式下对
inline变量检查更严，遇到模板推导失败可能误报
最麻烦的其实是初始化顺序和构建标准的一致性——这两点不盯紧，问题会延迟到链接或运行时才暴露。
