C++头文件初始化std::map报'my_map does not name a type'错误原因

• C++的全局作用域（包括头文件的顶层空间）仅允许放置变量定义、类型声明、函数声明/定义这类静态语法元素，不允许直接编写执行语句。
• 你写的my_map["name1"] = 0属于赋值操作的执行语句，编译器在全局作用域解析到这行代码时，会默认尝试将其识别为新的变量/类型定义，自然会抛出「my_map不指代一个类型」的报错。

方案1：C++11及以上版本（推荐） #

直接使用聚合初始化语法在变量定义阶段完成赋值，这属于变量定义的合法组成部分，可以放在全局作用域：

// 如果是头文件声明，要加extern避免多编译单元重复定义：
// extern std::map<std::string, double> my_map;

// 放在cpp文件的定义写法，或者头文件里单编译单元用的写法：
std::map<std::string, double> my_map = {
    {"name1", 0.0},
    {"name2", 0.0}
};

方案2：兼容旧C++标准 #

如果使用的C++版本不支持列表初始化，可以把赋值逻辑移到函数内部，比如在程序启动的main函数最开头执行初始化：

// 头文件里的声明
extern std::map<std::string, double> my_map;

// cpp文件里的定义
std::map<std::string, double> my_map;

// main函数开头执行赋值
int main() {
    my_map["name1"] = 0;
    my_map["name2"] = 0;
    // 后续业务逻辑
    return 0;
}

• 头文件中定义的全局变量如果被多个cpp文件引入，会触发重复定义错误，建议头文件仅用extern做声明，变量的定义和初始化统一放在对应的cpp实现文件中。

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