未预安装VulkanSDK时程序链接报错LNK2019：无法解析vkCreateInstance

核心原因 #

LNK2019错误的本质是链接器找不到vkCreateInstance的导入库文件。Windows平台下，动态链接库（.dll）仅在程序运行时生效，编译链接阶段必须依赖对应的导入库（.lib）来解析外部符号。你只提供了vulkan-1.dll，但缺少配对的vulkan-1.lib，导致链接失败。

具体修复步骤 #

1. 获取对应版本的vulkan-1.lib
   从你获取vulkan-1.dll的VulkanRT包中找到配套的vulkan-1.lib（通常和.dll同目录，或在lib子目录下），将其放到项目的二进制文件目录（比如binaries/lib）。注意要匹配项目架构：64位项目用64位lib，32位项目用32位lib，不匹配会导致链接失败。

2. 修改CMakeLists.txt配置链接规则
   在你的CMake脚本中添加以下配置，确保链接器能找到导入库并关联到目标程序：

   # 指向vulkan-headers的头文件目录（根据你的submodule路径调整）
   include_directories(${CMAKE_SOURCE_DIR}/third-party/vulkan-headers/include)
   
   # 指定导入库的搜索路径
   link_directories(${CMAKE_SOURCE_DIR}/binaries/lib)
   
   # 链接vulkan-1.lib到你的目标可执行文件
   target_link_libraries(你的项目名称 PRIVATE vulkan-1.lib)
   

   同时，确保你已经配置了将vulkan-1.dll复制到可执行文件输出目录的规则，比如：

   add_custom_command(TARGET 你的项目名称 POST_BUILD
                      COMMAND ${CMAKE_COMMAND} -E copy_if_different
                      "${CMAKE_SOURCE_DIR}/binaries/vulkan-1.dll"
                      $<TARGET_FILE_DIR:你的项目名称>)
   

3. 验证配置并重新构建
   清理之前的构建缓存，重新运行CMake生成项目文件，再执行编译。此时链接器应该能找到vulkan-1.lib中的符号，解决LNK2019错误。

额外注意事项 #

• 不要混淆静态库和导入库：如果你的项目是动态链接Vulkan，必须使用导入库（vulkan-1.lib），而非静态版本的lib（通常命名类似vulkan-1-static.lib）。
• 确保头文件路径正确：vulkan-headers中的vulkan.h必须能被编译器找到，否则会出现编译错误，而非链接错误。

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