Windows下用g++编译含OpenTelemetry的C++代码遇未定义引用错误

1. 如何正确链接OpenTelemetry C++ SDK？ #

• 更换适配MinGW的vcpkg包：你当前安装的opentelemetry-cpp:x64-windows是MSVC编译的库，和MinGW二进制不兼容，需要安装MinGW对应的triplet包。比如静态库版本：

  vcpkg install opentelemetry-cpp:x64-mingw-static
  

  或动态库版本：

  vcpkg install opentelemetry-cpp:x64-mingw-dynamic
  

• 编译时指定正确路径并按需链接子模块库，而非仅链接主库。以静态库为例，示例编译命令：

  g++ your_trace_program.cpp ^
  -I"C:/path/to/vcpkg/installed/x64-mingw-static/include" ^
  -L"C:/path/to/vcpkg/installed/x64-mingw-static/lib" ^
  -lopentelemetry_trace -lopentelemetry_common -lopentelemetry_resources ^
  -lopentelemetry_exporter_ostream_trace -lpthread ^
  -o your_trace_program.exe
  

  （Windows命令行用^换行，PowerShell替换为\）

2. 需要额外依赖或链接参数吗？ #

• 必须添加的链接项：
  • 线程库：MinGW环境下必须加-lpthread，OpenTelemetry内部依赖多线程机制。
  • 子模块库：OpenTelemetry采用模块化设计，不同功能对应不同子库：
    • 调用Resource::Create需链接-lopentelemetry_resources
    • 使用OStreamSpanExporter需链接-lopentelemetry_exporter_ostream_trace
    • 基础追踪功能需链接-lopentelemetry_trace和-lopentelemetry_common
  • 静态编译可选：若用静态库，可加-static参数，避免运行时依赖DLL文件。

3. OpenTelemetry是否支持MinGW，还是必须用MSVC？ #

• OpenTelemetry C++ SDK支持MinGW，并非必须使用MSVC，但要注意：
  • 必须安装对应MinGW triplet的vcpkg包（x64-mingw-static或x64-mingw-dynamic），不能用MSVC对应的x64-windows包。
  • 官方编译文档明确将MinGW列为支持的编译环境，只要配置好依赖和编译链即可正常使用。

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