离线使用vcpkg必须预先在有网机器上完整导出工具、ports目录及预下载源码包。执行vcpkg x-sync --download-root --no-build获取全部依赖资源，离线机需设置vcpkg_download_root、禁用metrics、固化toolchain路径，方可正常install与编译。
离线环境必须先有完整vcpkg源码和端口缓存
没外网就无法执行 git clone 或 bootstrap-vcpkg.bat 下载远程资源，更没法运行 vcpkg install 去拉取源码、打补丁、编译。所以第一步不是“怎么搭”，而是“怎么把能用的东西全拷进去”。核心是两样：vcpkg 工具本体 + 所有依赖库的完整端口（ports）目录 + 预下载的源码压缩包（或已编译产物）。这些必须在有网机器上提前准备好，再通过U盘/内网共享带入离线环境。
在有网机器上导出可离线使用的完整vcpkg镜像
官方支持离线构建，但需要手动触发资源预抓取。关键命令是 vcpkg x-add-version 和 vcpkg x-sync，配合 --download-root 指定缓存路径：
- 先确保 vcpkg 仓库已是最新：
git pull，再运行bootstrap-vcpkg.bat - 用
vcpkg search确认你要用的库名（如openssl、fmt），然后执行：vcpkg x-sync --download-root D:\vcpkg-offline-cache --no-build - 该命令会把所有 port 描述文件、依赖声明、以及每个库指定版本的源码压缩包（.zip/.tar.gz）全部下载到
D:\vcpkg-offline-cache，不编译 - 最后把整个
vcpkg目录（含ports/、scripts/、vcpkg.exe）和D:\vcpkg-offline-cache一起打包拷走
离线机器上启用私有源并跳过网络校验
直接解压后不能立刻用——默认配置仍会尝试访问 GitHub 或 Azure CDN。必须强制关闭网络行为，并指向本地缓存：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 设置环境变量：
VCPKG_DOWNLOAD_ROOT=D:\vcpkg-offline-cache（Windows 系统级或当前终端均需生效） - 禁用自动更新检查：在
vcpkg根目录下新建文件vcpkg.json，内容为：{"default-registry":{"kind":"builtin","baseline":"<your-baseline-hash>"}}</your-baseline-hash>（baseline hash 可从有网机上vcpkg x-baseline获取） - 最关键的一步：修改
scripts/buildsystems/vcpkg.cmake，找到if(NOT VCPKG_DISABLE_METRICS)块，把内部所有https://请求逻辑注释掉；否则 CMake configure 阶段仍可能卡住 - 验证是否生效：运行
vcpkg list应正常输出空列表；vcpkg install fmt:x64-windows应只解压+编译，不报 “Failed to download”
为什么 vcpkg integrate install 在离线环境大概率失败
这个命令本质是往 Visual Studio 的全局 MSBuild props 文件里写路径，但它会尝试调用 vcpkg.exe env 查询当前 triplet 和 root，而后者在离线时若未预设 VCPKG_ROOT 和 VCPKG_DOWNLOAD_ROOT，就会因无法解析 registry 而退出。更稳妥的做法是手动配置：
- 在 VS 项目属性 → “常规” → “附加包含目录” 中填：
D:\vcpkg\installed\x64-windows\include - 在 “链接器” → “常规” → “附加库目录” 中填：
D:\vcpkg\installed\x64-windows\lib - 或者，在 CMakeLists.txt 里显式设置：
set(CMAKE_TOOLCHAIN_FILE "D:/vcpkg/scripts/buildsystems/vcpkg.cmake")，并确保VCPKG_TARGET_TRIPLET环境变量已设为x64-windows
离线场景下，任何依赖实时网络响应的自动化步骤（比如自动注册表发现、metrics 上报、GitHub API 调用）都不可信，必须提前固化路径、关闭开关、绕过校验——这才是真正能跑通的关键。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
