如何使用__COUNTER__宏生成唯一变量名并在同模块中两次引用

解决方案 #

方案1：匿名命名空间方案（最推荐，零宏依赖，适配你的移植场景）

你原有的静态变量本身就是文件内部可见的属性，直接给每个.cpp文件的全局静态变量套入匿名命名空间即可，无需修改任何变量引用逻辑：

// 每个.cpp文件中把原静态变量外层套匿名命名空间
namespace {
    int myVar = 5;
}

// 后续引用变量名完全不需要修改
void someFunction(&myVar)
{
    ...
}

C++标准明确规定，匿名命名空间内的符号在编译单元内会被自动赋予唯一的内部标识，即使多个.cpp文件合并到同一编译单元，不同文件匿名命名空间下的同名符号也不会产生重定义冲突，不需要修改原有变量的引用代码，适配性最高。

方案2：单文件计数器绑定宏方案

如果必须用宏实现变量名唯一的需求，可以在每个.cpp文件顶部捕获一次__COUNTER__值作为当前文件的固定后缀，所有同文件内的变量引用都复用该后缀：

// 公共头文件中定义通用拼接宏
#define JOIN(symbol1, symbol2) _DO_JOIN(symbol1, symbol2)
#define _DO_JOIN(symbol1, symbol2) symbol1##symbol2

// 每个.cpp文件顶部仅添加一行，捕获当前全局唯一的计数器值
#define FILE_VAR_SUFFIX __COUNTER__
// 定义当前文件的唯一变量名
#define MY_VAR JOIN(myVar, FILE_VAR_SUFFIX)

// 两次引用的变量名完全一致
int MY_VAR = 5;
void someFunction(&MY_VAR)
{
    ...
}

该方案保证同文件内所有MY_VAR的调用都复用同一个提前捕获的__COUNTER__值，不会出现两次调用后缀不一致的问题，同时不同文件的FILE_VAR_SUFFIX捕获的计数器值全局唯一，不会出现重定义。

方案3：动态绑定声明引用宏方案

如果单文件内需要定义多个唯一变量可以用如下宏定义，单次声明后绑定后缀：

// 公共头文件定义
#define DECLARE_UNIQUE_VAR(type, name, init_val) \
    type JOIN(name, __COUNTER__) = init_val; \
    #define CURRENT_VAR JOIN(name, __COUNTER__ - 1)

// 使用方式：先声明变量，后续所有引用都用CURRENT_VAR即可
DECLARE_UNIQUE_VAR(int, myVar, 5)
void someFunction(&CURRENT_VAR)
{
    ...
}

该方案声明变量时消耗一次__COUNTER__生成后缀，后续引用通过__COUNTER__ - 1匹配到同一个后缀，保证声明和引用的变量名一致。

内容的提问来源于stack exchange，提问作者S. Arquet