MSVC下Vcpkg构建Vira共享库Release版本无提示失败问题

我有一个C库Vira，在Visual Studio 2022（MSVC 17.6）下能正常构建Debug和Release版本，WSL（Ubuntu 20.04.6/g 10.5.0）环境下构建也无警告。近期为了公开发布，我创建了vcpkg自定义overlay port，这个port在Linux下能正常构建安装，Windows Debug配置也能成功，但Windows Release配置构建失败。

执行命令：

.\vcpkg\vcpkg.exe install vira --overlay-ports .\source\repos\custom-overlay\

后，输出显示Release构建失败。查看install-x64-windows-rel-out.log发现，链接生成vira.dll时没有明确错误提示就直接失败。在portfile.cmake中添加vcpkg_check_linkage(ONLY_STATIC_LIBRARY)强制静态构建后，Windows版本可以正常安装。直接在Visual Studio中构建该版本的共享库没有问题，只有vcpkg构建时会出现这个问题，现寻求可能的故障原因排查方向。

对应的portfile.cmake内容如下：

vcpkg_from_git(
    OUT_SOURCE_PATH SOURCE_PATH
    URL git@aetd-git.gsfc.nasa.gov:vira/vira.git
    REF 77f084234d7f87b7d65d3139423716a2a8699062 # 0.8.0
    HEAD_REF vcpkg_dev
)

vcpkg_cmake_configure(
    SOURCE_PATH "${SOURCE_PATH}"
)

vcpkg_cmake_install()

vcpkg_cmake_config_fixup(
    PACKAGE_NAME "vira"
    CONFIG_PATH "lib/vira/cmake"
)

# Remove empty directories:
file(REMOVE_RECURSE "${CURRENT_PACKAGES_DIR}/lib/vira")
file(REMOVE_RECURSE "${CURRENT_PACKAGES_DIR}/debug/lib/vira")
file(REMOVE_RECURSE "${CURRENT_PACKAGES_DIR}/debug/include")
file(REMOVE_RECURSE "${CURRENT_PACKAGES_DIR}/debug/share")

file(INSTALL "${SOURCE_PATH}/LICENSE" DESTINATION "${CURRENT_PACKAGES_DIR}/share/${PORT}" RENAME copyright)
configure_file("${CMAKE_CURRENT_LIST_DIR}/usage" "${CURRENT_PACKAGES_DIR}/share/${PORT}/usage" COPYONLY)

排查方向 #

• 对比vcpkg与本地VS的编译/链接参数差异：vcpkg构建时使用封装的MSVC环境变量，可进入vcpkg构建目录（vcpkg/buildtrees/vira/x64-windows-rel）查看CMakeCache.txt，重点对比CMAKE_CXX_FLAGS_RELEASE、CMAKE_SHARED_LINKER_FLAGS_RELEASE与本地VS生成的参数，检查是否存在/LTCG（链接时间代码生成）不兼容、缺失必要链接选项等问题。
• 验证Release模式下的符号导出：MSVC的Release优化可能导致导出符号异常。用dumpbin /exports工具检查vcpkg构建的中间obj文件，确认是否存在预期的导出符号；对比本地VS构建的dll与vcpkg中间产物的符号差异，排查导出宏在NDEBUG定义下是否失效。
• 获取完整链接日志：默认日志可能隐藏细节，可修改portfile.cmake，在vcpkg_cmake_configure中添加LOGFILE_BUILD参数，或手动进入构建目录执行cmake --build . --config Release --verbose，获取完整链接过程输出，定位隐藏的依赖缺失、符号冲突等问题。
• 检查依赖库的链接方式：若Vira依赖其他vcpkg包，确认依赖在Release模式下的链接类型（静态/动态）是否与本地VS构建一致，排查vcpkg是否正确传递依赖的链接参数。
• 对齐CMake配置选项：vcpkg的vcpkg_cmake_configure会自动设置CMAKE_INSTALL_PREFIX、BUILD_SHARED_LIBS等变量，可在portfile.cmake中显式添加OPTIONS -DBUILD_SHARED_LIBS=ON强制动态构建，或传递本地VS使用的CMake选项，对比配置差异。
• 排查vcpkg工具链的特殊配置：vcpkg工具链会强制CMAKE_DEBUG_POSTFIX、安装路径结构等打包配置，检查库的CMakeLists.txt是否在处理这些变量时出现异常，比如Release模式错误引用Debug路径。

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