C++头文件定义的static unordered_map在类中访问为空问题排查

DevOps 小满

2026-10-6

问题根因

你对全局作用域下static关键字的作用理解正好相反：C++中全局作用域的static修饰的变量是内部链接属性，每一个包含该头文件的独立编译单元（即每个单独编译的.cpp文件），都会生成一份完全独立、互不干扰的变量实例。

你在A.cpp中填充的是A.cpp专属的chunks拷贝，而B.cpp中访问的是属于B.cpp自己的另一块独立的空chunks实例，因此输出大小为0。

修复方案

要实现跨编译单元共享全局变量，需要用extern关键字做声明，仅在单个.cpp中做定义：

修改A.h，去掉static，改为extern声明：

#include <unordered_map>
func1();
// 仅做声明，不分配内存
extern std::unordered_map<glm::ivec3, Chunk*, KeyHasher> chunks;

在A.cpp中添加全局变量的唯一实现：

#include "A.h"
// 全局唯一的chunks实例定义，整个程序仅会生成这一份
std::unordered_map<glm::ivec3, Chunk*, KeyHasher> chunks;

func1() {
    // ...原有逻辑保持不变
    chunks.insert(pair<glm::ivec3, Chunk*>(pos, chunk));
    cout << chunks.size(); // 此处输出大小符合预期
    // ...
}

修改后所有引入A.h的编译单元，访问的都是A.cpp中定义的唯一一份chunks实例，即可正常读取到填充的内容。