Windows下Go 1.15.8通过cgo链接C++共享库出现异常终止问题

该异常不是Go 1.15.8版本的bug，本质是Windows下cgo默认使用MinGW GCC作为编译/链接工具链，和你当前用MSVC（cl/link）编译生成的metadata.dll存在工具链、ABI不兼容断层，直接触发cgo.exe的运行时崩溃，连正常错误提示都抛不出来。

1. 基础环境校验 #

先执行以下命令确认基础配置：

• 运行go env CGO_ENABLED GOARCH CC获取当前cgo配置：
  • 若CGO_ENABLED=0，先执行go env -w CGO_ENABLED=1开启cgo支持
  • 若GOARCH不是amd64，确认安装的Go版本与编译的metadata.dll架构完全一致，禁止32位/64位混编
  • 默认CC值为gcc，说明当前cgo走的是MinGW工具链，和MSVC编译产物存在天然兼容问题

2. 兼容优先级最高的解决方案 #

直接统一使用MinGW GCC编译你的C++共享库，完全匹配cgo的默认工具链逻辑，不需要额外修改Go代码：

• 安装x86_64版本的MinGW-w64，将其bin目录加入系统环境变量PATH
• 替换原有MSVC的编译、链接命令为GCC版本：

g++ -shared -o metadata.dll metadata/metadata.cpp -Imetadata -lkernel32 -lole32 -O2

• 原有的extern "C"包裹逻辑不需要修改，GCC会正常导出C风格的函数符号，cgo可以直接识别链接
• 该方案和你参考的GCC跨平台示例的逻辑完全一致，是Windows下cgo调用C++共享库的通用稳定方案

3. 若必须使用MSVC编译的适配方案 #

如果坚持使用MSVC工具链，需要做两类针对性修改：

（1）修改头文件添加DLL导出声明 #

你原有的头文件没有导出函数声明，外部程序根本无法获取DLL内的函数符号，直接触发链接异常。将头文件修改为：

#pragma once
#ifdef __cplusplus
extern "C" {
#endif

// 新增导出/导入声明逻辑
#ifdef METADATA_EXPORTS
#define METADATA_API __declspec(dllexport)
#else
#define METADATA_API __declspec(dllimport)
#endif

METADATA_API int metadata_comment(const char* filename, int is_dir, char* comment, int buffer_size);

#ifdef __cplusplus
}
#endif

（2）调整编译命令与cgo编译器配置 #

• 修改MSVC编译命令，添加导出宏参数：

cl /c /EHsc /DUNICODE /D_UNICODE /DMETADATA_EXPORTS /Imetadata metadata/metadata.cpp
link /DLL /OUT:metadata.dll metadata.obj /MACHINE:X64 /INCREMENTAL:NO "kernel32.lib" "ole32.lib"

• 提前打开Visual Studio开发人员命令提示符（已加载cl、link的系统环境），执行以下命令修改Go的cgo默认编译器：

go env -w CC=cl.exe
go env -w CXX=cl.exe
go env -w CGO_LDFLAGS="-link.exe"

4. 其他容易触发异常的细节 #

• 确认项目根目录存在metadata.dll文件，对应cgo配置里-L.的搜索路径，避免链接器找不到库文件触发异常
• 确认cgo的临时工作目录（你日志里的N:\Temp\go-buildxxx路径）有完全读写权限，权限不足会导致cgo无法生成中间目标文件直接崩溃
• 运行程序时，确保系统PATH能找到metadata.dll，避免运行时加载失败的问题

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