使用Clang14编译Windows DLL遇lld-link路径错误求助

问题背景 #

• 使用Clang 14构建Windows DLL（Visual Studio编译器可正常构建）
• 依赖：Boost 1.80.0（已用Clang编译通过）、g3log（Visual Studio编译的库）
• 现象：源码编译通过，链接阶段报错：

lld-link : error : could not open 'D:\dev\github\vcpkg\installed\\x64-windows\debug\lib\*.lib': invalid argument

• 补充：项目文件中搜索不到"vcpkg"关键词

可能的原因 #

• vcpkg全局集成残留：即使项目未显式配置vcpkg，vcpkg的全局集成（如vcpkg integrate install生成的用户配置）或环境变量会自动向Clang/LLVM注入链接路径，报错中的双反斜杠\\是路径转义错误，导致链接器无法解析通配符*.lib。
• VS环境变量继承：若在VS开发者命令提示符中运行Clang，可能继承了VS或vcpkg的LIB环境变量，其中包含无效的vcpkg路径。
• 依赖库隐式引入：g3log或Boost的库文件可能隐式依赖vcpkg管理的组件，导致链接器自动尝试加载vcpkg路径下的库。
• 隐藏配置残留：项目的.vcxproj.user、CMakeCache.txt等隐藏配置文件中，可能存在未清理的vcpkg路径引用，虽未在主项目文件中搜索到，但仍会生效。

解决方案 #

• 取消vcpkg全局集成：运行命令 vcpkg integrate remove，删除%APPDATA%\vcpkg\vcpkg.config文件，清理全局注入的配置。
• 清理环境变量：在编译链接前执行 set LIB= 清空库路径环境变量，或手动移除LIB、VCPKG_ROOT中包含vcpkg的条目。
• 显式指定依赖库：避免使用通配符*.lib，手动列出需要链接的具体库（如boost_system.lib、g3log.lib），同时确保/LIBPATH仅指向Boost和g3log的库目录。
• 检查依赖库的依赖项：使用dumpbin /dependents g3log.lib查看g3log是否依赖vcpkg管理的库，若有则替换为手动编译的对应库。
• 检查隐藏配置文件：查看项目目录下的.vcxproj.user、CMakeCache.txt等文件，确认是否存在vcpkg路径引用并删除。

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