C++ 17 内联变量

C++17 引入了内联变量（inline variables）这一特性，它主要用来解决“变量定义写在头文件里会重复定义”的问题。这个特性对写库、写公共配置、写静态成员变量都很实用。

1. 先看一下问题出在哪里

在 C++17 之前，如果我们想在类里定义一个静态成员变量，通常要分成“声明”和“定义”两步：

// header.h
struct MyClass {
    static const int value;
};

// source.cpp
#include "header.h"

const int MyClass::value = 42;

如果你把定义也写进头文件里，并且这个头文件被多个 .cpp 文件包含，那么链接阶段就很容易报 multiple definition 错误。

对于一些全局常量、配置项、或者头文件库来说，这种写法会比较麻烦，因为你总得额外找个 .cpp 去放定义。

2. C++17 的内联变量怎么写？

有了 inline variable 之后，可以直接在头文件里完成定义：

struct MyClass {
    inline static const int value = 42;
};

这时即使多个源文件都包含了这个头文件，也不会因为重复定义而链接失败。

2.1 普通全局变量也可以

// config.h
inline const char* appName = "demo";
inline int maxCount = 100;

以前这种写法一般不推荐直接放在头文件里，现在加上 inline 以后就可以了。

3. 常见使用场景

3.1 类中的静态成员变量

这是最常见的场景：

#include <iostream>
using namespace std;

class Config
{
public:
    inline static int timeout = 30;
};

int main()
{
    cout << Config::timeout << endl;
    return 0;
}

相比旧写法，这种方式最大的好处就是：定义和声明放在一起了，代码更集中，也更不容易漏掉。

3.2 头文件中的共享配置

如果项目中有一些所有模块都会用到的配置常量，也适合写成内联变量：

// setting.h
inline constexpr int kBufferSize = 1024;
inline constexpr double kPi = 3.1415926;

这种写法对于头文件工具库尤其方便。

3.3 模板代码里的静态成员

模板类很多时候本来就喜欢把实现写在头文件里，内联变量能减少额外定义的麻烦：

template <typename T>
struct Counter {
    inline static int count = 0;
};

4. 它和函数 inline 是一回事吗？

名字一样，但作用场景不同。

• 函数上的 inline：最早更多是给编译器一个“可以内联展开”的提示，不过现代编译器是否真的展开，主要还是自己决定。
• 变量上的 inline：重点不在性能，而在于允许这个变量在多个翻译单元中定义，并把它们视为同一个实体。

所以这里的 inline 更应该理解成“满足 ODR（单一定义规则）的特殊写法”，而不是“性能优化关键字”。

5. 和 constexpr 的关系

很多时候我们会把它们一起用：

inline constexpr int version = 3;

constexpr 表示这个值在编译期可求值，inline 则保证它可以安全地写在头文件里。
如果只是单纯想定义一个头文件常量，这两个关键字搭配起来很顺手。

6. 使用时要注意的地方

6.1 所有定义必须保持一致

虽然 inline 允许你在多个翻译单元里看到这个定义，但它们本质上仍然应该是同一个定义。
如果你在不同地方写出了不同的初始化内容，那仍然属于错误用法。

6.2 inline 不能代替一切设计

有些变量本来就不应该暴露在头文件里，比如生命周期复杂、依赖初始化顺序的全局对象，这种情况下即便能写成内联变量，也不一定是好设计。

6.3 项目标准要一致

内联变量是 C++17 才有的特性，如果项目仍然是 C++11 或 C++14 编译标准，那就不能直接使用。

7. 一个对比示例

C++17 之前

// logger.h
class Logger {
public:
    static int level;
};

// logger.cpp
int Logger::level = 1;

C++17 之后

// logger.h
class Logger {
public:
    inline static int level = 1;
};

从写法上看，确实简洁很多。

总结

C++17 的内联变量，本质上是把以前“必须拆到 .cpp 文件里定义”的一部分变量，重新带回到了头文件里，而且不会再引发重复定义问题。
它非常适合用于类静态成员、公共常量、模板代码和头文件库。需要注意的是，它解决的是定义位置和链接规则的问题，并不是在讲性能优化。把这一点理解清楚，用起来就不会混淆了。