本文详解 go 程序通过 cgo 调用 msvc 编译的 windows dll 的标准方法，重点解决符号未定义（undefined reference）链接错误，涵盖 cflags/ldflags 配置、导入库（.lib）必要性及常见误区。
在 Windows 平台上使用 Go 调用自定义 DLL 函数时，不能直接将 .dll 文件路径传给链接器（如 -LC:/.../bin MyModule.dll），这是导致 undefined reference to 'moduleImpl_len' 错误的根本原因。GCC/MinGW（cgo 默认使用的工具链）在链接阶段需要的是 导入库（Import Library，即 .lib 文件），而非 .dll 本身——.dll 仅在运行时动态加载，链接期必须通过 .lib 提供符号定义和跳转桩（thunk）。
✅ 正确做法是：
- 确保你拥有与 DLL 对应的 .lib 文件（MSVC 编译 DLL 时默认生成，例如 MyModule.lib）；
- 将 .lib 放置于 #cgo LDFLAGS 可访问路径，并使用 -l 标志链接（不带 .lib 后缀）；
- 正确设置头文件路径与链接库路径。
修改你的 cgo 指令如下：
//#cgo CFLAGS: -IC:/Repos/Module/include //#cgo LDFLAGS: -LC:/Repos/Module/go/bin -lMyModule //#includeimport "C"
⚠️ 注意事项：
- -L 指定的是 目录路径（如 -LC:/Repos/Module/go/bin），不是文件路径；
- -lMyModule 会令链接器查找 libMyModule.a（MinGW）或 MyModule.lib（MSVC 兼容模式下，需确保 CGO_ENABLED=1 且使用 gcc-based 工具链，如 TDM-GCC 或 MinGW-w64）；
- 若你只有 .dll 没有 .lib，可使用 dlltool（MinGW）从 DLL 生成导入库：
dlltool -d MyModule.def -l libMyModule.a --dllname MyModule.dll
（其中 .def 文件可通过 dumpbin /exports MyModule.dll > exports.txt 手动整理生成）
- 不要依赖 syscall.LoadDLL + FindProc（即纯反射调用）来绕过链接问题——这虽可行，但丧失了类型安全、编译期检查和 cgo 的自动内存管理优势。
? 补充建议：
- 在 MyModule.h 中确保函数声明为 extern "C"（已满足），避免 C++ 名字修饰（name mangling）；
- 使用 go build -x 查看实际调用的 gcc 命令，确认 -lMyModule 和 -L... 是否出现在链接参数中；
- 若仍报错，请运行 nm -C libMyModule.a | grep moduleImpl_len（MinGW）或 dumpbin /symbols MyModule.lib | findstr moduleImpl_len（MSVC）验证符号是否真实存在且未被修饰。
遵循上述配置后，C.moduleImpl_len() 即可成功链接并调用，无需退化至底层 syscall 方案。
