C++包含自定义命名空间时出现变量已定义的LNK2005链接错误如何解决

你出现这个问题的核心原因，是完全颠倒了C++项目里头文件、源文件的分工逻辑，和命名空间的使用没有任何关系：

• 你写的namespace.cpp文件里包含了带实际内存分配的变量定义int A = 0，同时又在main.cpp里通过#include "namespace.cpp"把这个实现文件的全部代码原封不动展开到了main.cpp的编译单元中。
• 编译器的工作流程是逐cpp文件独立编译生成对应的obj文件：
  1. 编译namespace.cpp时，里面定义的MyNamespace::A会被分配实际内存，符号定义会被记录到namespace.obj中
  2. 编译main.cpp时，因为include展开了namespace.cpp的内容，同样会对MyNamespace::A做一次实际内存分配，对应的符号定义会被记录到main.obj中
• 等到链接阶段，链接器发现MyNamespace::A这个符号在两个obj文件里都存在实体定义，就会抛出LNK2005重复定义报错。
• 这里要特别说明：你加的#pragma once根本解决不了这个问题——这个宏的作用只是避免同一个编译单元内部的重复include，完全管不了不同编译单元之间的重复定义。

严格遵循「头文件放声明、源文件放定义」的规则拆分代码：

1. 新建头文件namespace.h，用来被其他文件include，里面只放变量的声明，不做实际内存分配：

// namespace.h
#pragma once
namespace MyNamespace {
    // 加extern关键字，明确这只是外部声明，不在这里分配内存
    extern int A;
}

2. 保留实现文件namespace.cpp，在里面做变量的实际定义赋值：

// namespace.cpp
#include "namespace.h"
namespace MyNamespace {
    int A = 0;
}

3. 修改main.cpp的引用路径，只引入头文件，绝对不要直接引入cpp实现文件：

// main.cpp
#include "namespace.h"

int main() {
    // 正常访问 MyNamespace::A 即可
    return 0;
}

如果不想拆成头文件+源文件的结构，C++17及以上版本可以直接在变量定义上加inline关键字，让编译器自动保证全局范围内这个变量只有一份实体，不会触发重复定义：

// 可以直接作为被include的头文件内容
#pragma once
namespace MyNamespace {
    inline int A = 0;
}

注意：inline内联变量的写法只适用于C++17及之后的标准，低版本编译器不支持。

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