PAYATHON 2026

vcpkg 构建包报错缺少 debug/share 目录

数据小陈

结论

这个报错的原因是 Debug 安装阶段没有把 ankicpp 的 CMake package 配置文件安装到 ${CURRENT_PACKAGES_DIR}/debug/share/ankicpp,vcpkg_cmake_config_fixup 因此找不到目标目录。vcpkg 不需要你手工创建这个空目录。优先修改上游 CMakeLists.txt 的 install 规则;如果只是本地打包验证,可以在 portfile.cmake 里把 release 的 share/ankicpp 临时复制到 debug/share/ankicpp,再调用 fixup。

debug/share 是做什么的

vcpkg 默认会构建 Debug 和 Release 两套产物,vcpkg_cmake_install() 会分别安装到包目录和包目录下的 debug 子目录。vcpkg_cmake_config_fixup 会处理 share/<pkg> 与 debug/share/<pkg> 下的 *Config.cmake、*Targets.cmake 等文件,修正其中的安装前缀和导入目标路径,避免 Debug 配置引用 Release 路径。debug/share/ankicpp 是 Debug 配置的暂存位置;如果缺失,fixup 就会报出你看到的错误。

解决步骤

1. 先检查 CMake 安装规则

确认项目会无条件安装 package config,不要只在 Release 或某个选项打开时才执行。示例结构如下,目标名和路径按你的项目调整:

include(CMakePackageConfigHelpers)

install(TARGETS ankicpp EXPORT ankicppTargets ...)

install(EXPORT ankicppTargets
    FILE ankicppTargets.cmake
    NAMESPACE ankicpp::
    DESTINATION ${CMAKE_INSTALL_DATADIR}/ankicpp)

write_basic_package_version_file(
    "${CMAKE_CURRENT_BINARY_DIR}/ankicppConfigVersion.cmake"
    VERSION ${PROJECT_VERSION}
    COMPATIBILITY SameMajorVersion)

configure_package_config_file(
    "${CMAKE_CURRENT_SOURCE_DIR}/cmake/ankicppConfig.cmake.in"
    "${CMAKE_CURRENT_BINARY_DIR}/ankicppConfig.cmake"
    INSTALL_DESTINATION ${CMAKE_INSTALL_DATADIR}/ankicpp)

install(FILES
    "${CMAKE_CURRENT_BINARY_DIR}/ankicppConfig.cmake"
    "${CMAKE_CURRENT_BINARY_DIR}/ankicppConfigVersion.cmake"
    DESTINATION ${CMAKE_INSTALL_DATADIR}/ankicpp)

如果这段 install 被 if(CMAKE_BUILD_TYPE STREQUAL "Release") 之类的条件包住,Debug 安装就不会生成 debug/share/ankicpp,fixup 也会失败。

2. 核对 portfile 里的 CONFIG_PATH

如果配置文件实际安装在 share/ankicpp,现有的 vcpkg_cmake_config_fixup(PACKAGE_NAME "ankicpp") 参数没问题,要解决的是 Debug 安装缺失。如果实际安装在 lib/cmake/ankicpp,则需要显式指定路径:

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

不要盲目改 CONFIG_PATH,先用打包目录确认 share/ankicpp 或 lib/cmake/ankicpp 到底哪个存在。

3. 临时办法:复制 release 配置到 debug 目录

如果只是想先让 overlay port 构建通过,可以在 vcpkg_cmake_config_fixup 之前加一段复制逻辑。它只适用于 share/ankicpp 这种默认布局;如果配置在 lib/cmake/ankicpp,需要把路径同步换掉。

if(NOT EXISTS "${CURRENT_PACKAGES_DIR}/debug/share/ankicpp")
    file(MAKE_DIRECTORY "${CURRENT_PACKAGES_DIR}/debug/share")
    file(COPY "${CURRENT_PACKAGES_DIR}/share/ankicpp"
         DESTINATION "${CURRENT_PACKAGES_DIR}/debug/share")
endif()

vcpkg_cmake_config_fixup(PACKAGE_NAME "ankicpp")

这段代码会生成缺失的 debug/share/ankicpp,并把 release 的 CMake 配置复制过去供 fixup 修正。不要只 file(MAKE_DIRECTORY ...) 建空目录。那样 fixup 可能不再报目录不存在,但最终包里仍然没有可用的 Debug 配置。

4. 清理后重试

改完 portfile 后,清掉旧的 buildtrees 和 packages,避免缓存干扰:

rm -rf buildtrees/ankicpp packages/ankicpp_x64-linux
vcpkg install ankicpp --overlay-ports=./ankicpp/custom-overlay

注意事项

  • 优先修改上游 CMakeLists.txt,让 Debug 和 Release 都安装同一套 package config;复制目录只是打包阶段的备用办法。
  • 如果项目根本不导出 CMake config,就不要调用 vcpkg_cmake_config_fixup,而应自己提供并安装 ankicppConfig.cmake 和 ankicppTargets.cmake。
  • 你 portfile 里的 file(TOUCH "${CURRENT_PACKAGES_DIR}/share/${PORT}/usage-accurate") 不是 vcpkg 标准的 usage 文件名。若希望 vcpkg 展示用法,通常应把 usage 文件安装到 share/${PORT}/usage,而不是创建 usage-accurate。
  • 静态库包同样可能需要 CMake config;ONLY_STATIC_LIBRARY 不会自动绕过 fixup。

备注:内容仅供参考。