不使用class，如何在C++中定义模块内私有变量避免命名冲突？

1. 匿名命名空间（最推荐） #

将模块内的私有变量包裹在cpp文件的匿名命名空间中，这些变量的作用域会被严格限制在当前编译单元（即该cpp文件）内，其他模块无法访问，彻底避免同名冲突。

示例代码：

// 你的模块cpp文件（比如mod_calculation.cpp）
namespace {
    // 所有仅模块内使用的变量都放这里
    int total_count;
    double precision = 0.0001;
    char temp_buffer[512];
}

// 对外暴露的模块函数（头文件中声明）
void calc_update_precision(double new_val) {
    precision = new_val; // 可以正常访问匿名空间内的变量
}

对应的头文件仅声明对外接口：

// mod_calculation.h
void calc_update_precision(double new_val);

2. static关键字限定作用域 #

在cpp文件中给变量添加static修饰符，同样能将变量作用域限制在当前编译单元内。不过C++标准更推荐匿名命名空间（static在模板等场景下存在行为不一致问题），但单纯处理全局私有变量时完全可用。

示例代码：

// mod_io.cpp
static int file_handle; // 仅当前cpp可见
static char log_path[256] = "./log.txt";

void io_open_log() {
    // 可以访问file_handle和log_path
}

你移到cpp仍冲突的原因排查 #

如果已经把变量移到cpp但还是有冲突，大概率是没有做作用域限制：

// 错误写法：这种全局变量会被整个程序可见，其他模块同名变量会冲突
int total_count;

只需给这类变量加上匿名命名空间包裹或static修饰，即可解决问题。

头文件的正确处理方式 #

绝对不要在头文件中直接定义变量（会被每个包含它的cpp复制一份，引发多重定义或全局冲突）。如果是模块私有变量，完全不需要在头文件中声明，仅在cpp的私有作用域内定义即可；如果是需要跨编译单元共享的变量，才用extern在头文件声明，cpp中定义。

内容的提问来源于stack exchange，提问作者Junyang Liu