在项目中集成Vulkan Shaderc时遭遇LNK2019未解析外部符号链接错误求助

嘿，我一眼就看出问题所在了——你已经成功引入了Vulkan库，但漏掉了Shaderc库的链接步骤！LNK2019错误的本质是：编译器能通过头文件找到Shaderc类（比如shaderc::Compiler）的定义，但到了链接阶段，找不到这些类对应的底层实现库文件。

先看看你提供的代码和错误信息：

我的CMakeLists.txt内容：

find_package(Vulkan REQUIRED)
target_link_libraries(${PROJECT_NAME} INTERFACE Vulkan::Vulkan)

shader.cpp中的代码片段：

void OpenGLShader::Compile(const std::unordered_map<GLenum, std::string>& shaderSources)
{       
    vk::Buffer;
    shaderc::Compiler compiler;
    shaderc::CompileOptions options;
}

遇到的链接错误：

out\build\x64-debug\GLContext.lib(OpenGLShader.cpp.obj) : error LNK2019: unresolved external symbol shaderc_compiler_release referenced in function "public: __cdecl shaderc::Compiler::~Compiler(void)" (??1Compiler@shaderc@@QEAA@XZ)
out\build\x64-debug\GLContext.lib(OpenGLShader.cpp.obj) : error LNK2019: unresolved external symbol shaderc_compile_options_initialize referenced in function "public: __cdecl shaderc::CompileOptions::CompileOptions(void)" (??0Compi...

解决方案：补充Shaderc库的查找与链接 #

Shaderc是Vulkan生态中独立的着色器编译组件，不会随Vulkan库自动引入，需要单独处理：

方法1：系统已安装Shaderc的情况

如果你的开发环境已经通过包管理器（比如vcpkg、apt）或者手动安装了Shaderc，只需要修改CMakeLists.txt，添加Shaderc的查找和链接：

find_package(Vulkan REQUIRED)
# 新增：查找Shaderc库
find_package(shaderc REQUIRED)

# 新增：将Shaderc库链接到项目
target_link_libraries(${PROJECT_NAME} INTERFACE Vulkan::Vulkan shaderc::shaderc)

注意：不同版本的Shaderc导出的目标名称可能略有差异，比如静态库版本可能是shaderc::shaderc_static，动态库是shaderc::shaderc_shared，可以根据你的实际使用情况调整。

方法2：自动拉取Shaderc源码构建（跨平台推荐）

如果你的环境里没有预安装Shaderc，推荐用CMake的FetchContent模块自动拉取源码并构建，这样能保证版本匹配且跨平台可用：

find_package(Vulkan REQUIRED)

# 新增：通过FetchContent拉取Shaderc源码
include(FetchContent)
FetchContent_Declare(
    shaderc
    GIT_REPOSITORY https://github.com/google/shaderc.git
    GIT_TAG v2024.1 # 可以替换为你需要的稳定版本
)
FetchContent_MakeAvailable(shaderc)

# 链接Vulkan和Shaderc库
target_link_libraries(${PROJECT_NAME} INTERFACE Vulkan::Vulkan shaderc::shaderc)

额外检查项 #

1. 确保构建类型匹配：Debug版本的项目要链接Debug版本的Shaderc库，Release同理，混用时也会触发链接错误。
2. 如果是手动指定Shaderc路径，需要在CMake中设置shaderc_DIR指向Shaderc安装目录下的Config.cmake文件所在路径。

备注：内容来源于stack exchange，提问作者GloriousDemonFist