全局Map符号未解析(LNK2001)：如何从共享库共享全局Map？

我有一个包含多个全局std::map的库，结构如下：

头文件(header0)声明 #

extern std::map<AVPixelFormat, std::string> AVPixelFormatMap;
extern std::map<AVMediaType, std::string> AVMediaTypeMap;
extern std::map<AVCodecID, std::string> AVCodecIDMap;

cpp文件(cpp0)定义 #

std::map<AVPixelFormat, std::string> AVPixelFormatMap
{
    {AV_PIX_FMT_NONE, "AV_PIX_FMT_NONE: None"},
    // 其他键值对定义...
};
// 另外两个map的类似定义...

在另一个库中，我在cpp文件中包含header0并链接library0.lib，但编译器报LNK2001未解析外部符号错误：

Severity Code Description Project File Line Suppression State Details
Error LNK2001 unresolved external symbol "class std::map<enum
AVPixelFormat,class std::basic_string<char,struct
std::char_traits,class std::allocator >,struct
std::less,class std::allocator<struct
std::pair<enum AVPixelFormat const ,class
std::basic_string<char,struct std::char_traits,class
std::allocator > > > > > AVPixelFormatMap"
(?AVPixelFormatMap@@3V?$map@W4AVPixelFormat@@V?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@U?$less@W4AVPixelFormat@@@3@V?$allocator@U?$pair@$$CBW4AVPixelFormat@@V?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@@std@@@3@@std@@A) library0 path/to\library0.obj 1

我尝试在声明时改用extern __declspec(dllexport) std::map<...>，但错误依旧。

我的需求是：在共享库中使用这些Map，且无需在其他使用它的库中内联它们。请问我哪里出错了？

你遇到的核心问题是Windows平台下共享库的符号导出/导入规则未正确处理，只加__declspec(dllexport)不够，需区分编译库和使用库的场景：

• 头文件用宏切换导出/导入状态
  定义一个宏（比如MY_LIB_EXPORT），编译共享库时将其设为__declspec(dllexport)，使用该库的项目中设为__declspec(dllimport)，统一头文件声明：

  #ifdef MY_LIB_EXPORT
  #define MY_LIB_API __declspec(dllexport)
  #else
  #define MY_LIB_API __declspec(dllimport)
  #endif
  
  extern MY_LIB_API std::map<AVPixelFormat, std::string> AVPixelFormatMap;
  extern MY_LIB_API std::map<AVMediaType, std::string> AVMediaTypeMap;
  extern MY_LIB_API std::map<AVCodecID, std::string> AVCodecIDMap;
  

• 编译共享库时定义导出宏
  在library0的项目设置中（比如VS的「项目属性→C/C++→预处理器→预处理器定义」）添加MY_LIB_EXPORT，确保编译库时这些全局Map被标记为导出符号，生成的.lib会包含导出信息。

• 检查链接的库文件
  确认链接的library0.lib是共享库编译生成的导入库，而非静态库的.lib；同时检查链接路径是否正确，未指向旧版本文件。

• 避免符号名混淆
  确保AVPixelFormat等枚举类型在使用库的项目中声明一致——比如没有因命名空间、宏定义差异导致枚举类型符号名和库中不匹配，这会让编译器判定为不同符号，触发未解析错误。

• 统一标准库编译选项
  Windows下导出std::map这类标准容器时，库和使用库的项目必须用相同编译器版本、相同编译选项（比如MD/MT运行时库、调试/发布模式），否则会因标准库实现差异导致符号不匹配。

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