使用libgit2+Qt+MSVC编译报未解析外部符号，但VC++项目可正常运行

我明白你现在遇到的困境：同样用MSVC 2017 64位编译出来的libgit2库，在纯VS的VC++项目里能正常跑，但放到Qt Creator的Qt项目中就触发未解析外部符号错误，哪怕已经按方案调整cmake参数重新编译过库。这大概率是Qt构建系统和纯VS项目的配置差异导致的，下面是几个针对性的排查和解决方向：

• 严格对齐编译工具链与运行时库配置
  首先确认你的Qt项目确实在使用MSVC 2017 64位编译器，和构建libgit2时的工具链完全一致。另外重点检查运行时库：libgit2默认编译用的是多线程DLL模式（/MD对应Release，/MDd对应Debug），你需要在Qt Creator的项目构建设置里，把C++编译器的运行时库选项也改成完全匹配的模式——如果两边运行时库类型不统一，必然会出现符号链接问题。

• 完善Qt项目的链接配置细节
  在Qt的.pro文件里，要精准指定libgit2的头文件路径、库路径，还要区分Debug/Release版本的库文件：

  INCLUDEPATH += path/to/libgit2/include
  LIBS += -Lpath/to/libgit2/lib
  # 区分Debug和Release版本的库
  CONFIG(debug, debug|release): LIBS += -lgit2d
  CONFIG(release, debug|release): LIBS += -lgit2
  

  另外，libgit2在Windows上依赖winhttp.lib、secur32.lib等系统库，纯VS项目可能会自动处理这些依赖，但Qt Creator需要你手动把这些库也加到LIBS配置里，否则会缺失部分符号。

• 优化libgit2的cmake编译参数
  你之前用的cmake %PATH_TO_LIBGIT2_SOURCE% -DTHREADSAFE=ON -DSTDCALL=OFF没问题，但可以额外明确指定库的类型：如果用动态库就加DBUILD_SHARED_LIBS=ON，静态库就加DBUILD_SHARED_LIBS=OFF。同时确保编译libgit2时的CMAKE_BUILD_TYPE和你的Qt项目一致（Debug或Release），混合模式的链接也会触发符号错误。

• 清理Qt Creator的构建缓存
  Qt Creator的构建缓存有时候会残留旧的链接信息，导致新配置不生效。你可以直接删除项目的构建目录，然后重新执行qmake和完整构建操作，确保所有链接配置都是最新的。

如果以上方法都试过还是没解决，建议把Qt项目编译输出里的具体未解析符号信息贴出来——比如符号是属于Debug还是Release版本，或者是不是某个特定libgit2功能模块的符号，这样能更精准地定位问题。

内容的提问来源于stack exchange，提问作者Abdelilah El Aissaoui