vcpkg与Docker缓存集成：私有依赖缓存方案咨询

现有配置 #

Dockerfile片段 #

[...]
RUN vcpkg.exe install libpng # 利用Docker缓存避免重复编译
WORKDIR c:/app
COPY . . # 此步骤后修改代码会触发重新编译
RUN cmake -S . -B build

vcpkg.json内容 #

{
  "name": "my-proj",
  "version": "0.1.0",
  "dependencies": [
    {"name": "libpng"},
[...]

核心问题 #

目前vcpkg.exe install libpng能借助Docker缓存避免重复编译，但需要安装未在vcpkg主注册表中的私有依赖，且无法通过vcpkg-configuration.json指定替代注册表，需找到简单方案构建并缓存该私有依赖，避免在cmake -S . -B build阶段重新编译。

可行方案 #

方案1：提前复制私有端口文件到vcpkg ports目录 #

在Docker镜像构建的早期阶段（COPY . .之前），将私有依赖的vcpkg端口文件（包含portfile.cmake、vcpkg.json等的目录）复制到vcpkg的ports目录下，再执行vcpkg install安装该私有依赖。Docker会缓存这个安装步骤，仅当私有端口文件变化时才会重新编译。

示例Dockerfile修改：

# 假设本地私有依赖端口文件在 ./private-ports/myprivlib 目录
COPY ./private-ports/myprivlib /path/to/vcpkg/ports/myprivlib
RUN vcpkg.exe install myprivlib libpng
# 后续再复制应用代码
WORKDIR c:/app
COPY . .
RUN cmake -S . -B build

方案2：使用vcpkg的overlay ports功能 #

利用vcpkg的overlay ports特性，在安装时指定私有端口的目录，同样将该步骤放在复制应用代码之前，让Docker缓存执行结果。

示例Dockerfile修改：

# 先将私有端口目录复制到镜像内
COPY ./private-ports /private-ports
# 通过--overlay-ports指定私有端口路径，执行依赖安装
RUN vcpkg.exe install libpng myprivlib --overlay-ports=/private-ports
WORKDIR c:/app
COPY . .
RUN cmake -S . -B build

方案3：预编译私有依赖并缓存二进制包 #

若私有依赖不经常变动，可提前在本地或CI环境编译好该依赖的vcpkg二进制包，将二进制包复制到vcpkg的downloads目录（或指定缓存目录），再执行vcpkg install。vcpkg会优先使用已有二进制包，避免重新编译。

示例Dockerfile修改：

# 复制预编译的私有依赖二进制包到vcpkg缓存目录
COPY ./prebuilt/myprivlib*.zip /path/to/vcpkg/downloads/
RUN vcpkg.exe install myprivlib libpng
WORKDIR c:/app
COPY . .
RUN cmake -S . -B build

以上方案核心逻辑一致：将私有依赖的安装步骤放在COPY . .之前，让Docker缓存依赖的编译/安装结果，仅当私有依赖的定义（端口文件或预编译包）变化时才会重新执行该步骤，应用代码的修改不会触发依赖的重新编译。

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