GitHub Actions Windows环境下CMake库链接测试套件报错求助

项目基础情况 #

• 维护的CMake开源项目可在Linux、macOS环境下平稳运行，为提升跨平台可移植性新增Windows平台构建适配能力
• 基于GitHub Actions配置标准CMake工作流，在ubuntu-latest、windows-latest、macos-latest三个环境下触发构建任务
• 工作流在Linux、macOS下可正常完成全流程构建、测试，仅Windows环境连续出现两类链接报错

初始适配与第一类报错 #

• 最初在CMakeLists.txt中添加的Windows条件分支配置：

  if(WIN32)
      set(FETCHCONTENT_BASE_DIR "C:/Users/$ENV{USERNAME}/AppData/Local/Temp")
  endif()
  

• 该配置可正常将FetchContent拉取的第三方依赖存储到系统临时目录，避免依赖写入源码目录触发CMake校验错误，但Windows环境下测试套件无法定位库文件，触发LNK1181错误：

  LINK : fatal error LNK1181: cannot open input file '..\Release\libeztp.lib'
  

调整配置后的第二类报错 #

• 参考构建经验新增两项Windows专属配置后，库文件可被正常识别，但出现未解析导出符号的链接错误：

  if(WIN32)
      set(FETCHCONTENT_BASE_DIR "C:/Users/$ENV{USERNAME}/AppData/Local/Temp")
      set(CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS TRUE)
      set(BUILD_SHARED_LIBS TRUE)
  endif()
  

• 报错核心为测试链接阶段无法找到全局符号eztp::dice的导出定义：

  mainTest.obj : error LNK2019: unresolved external symbol "class std::map<int,class eztp::Die,struct std::less<int>,class std::allocator<struct std::pair<int const ,class eztp::Die> > > eztp::dice" referenced in 测试用例入口
  D:\a\libeztp\libeztp\build\tests\Release\tests.exe : fatal error LNK1120: 1 unresolved externals
  

报错关联的代码定义 #

• 头文件dice.hpp中的符号声明：

  namespace eztp {
      class Die {
          // 类内部实现
      };
  
      extern std::map<int, Die> dice;
  }
  

• 源文件dice.cpp中的符号定义：

  std::map<int, eztp::Die> eztp::dice = {
          {0,   eztp::Die(0)},
          {1,   eztp::Die(1)},
          {2,   eztp::Die(2)},
          {4,   eztp::Die(4)},
          {6,   eztp::Die(6)},
          {8,   eztp::Die(8)},
          {10,  eztp::Die(10)},
          {12,  eztp::Die(12)},
          {20,  eztp::Die(20)},
          {100, eztp::Die(100)}
  };
  

问题根因与适配方向 #

• 第一类LNK1181报错根因：Windows下MSVC生成器的库文件输出路径、命名规则与类Unix系统存在差异，测试目标硬编码的相对路径库查找规则未适配多配置生成器的输出结构
• 第二类未解析符号报错根因：MSVC链接Windows共享库时，要求跨库边界引用的符号必须显式标记导出属性，仅开启CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS无法覆盖全局变量的部分导出场景，导致定义在库内的全局变量未被写入导出表
• 低成本适配方案（无长期Windows开发计划可直接采用）：
  • 移除测试目标中硬编码的库文件路径与查找逻辑，直接通过CMake目标接口关联库目标（如target_link_libraries(tests PRIVATE eztp)），由CMake自动适配不同平台的库查找、链接规则
  • 若无需构建Windows共享库，直接删除BUILD_SHARED_LIBS TRUE配置，Windows下静态库无需符号导出即可被链接，可完全规避共享库导出规则的适配成本

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