将大型多项目Visual Studio C++解决方案从NuGet迁移至vcpkg

核心配置思路 #

针对你的场景，通过vcpkg解决方案级集成+PackageReference替代packages.config，可以实现统一依赖管控，同时保留内部NuGet包的使用，完全满足你的需求。

步骤1：初始化解决方案级vcpkg配置 #

1. 在解决方案根目录创建vcpkg.json，统一声明所有第三方依赖的版本，确保所有项目共用同一版本：

   {
     "name": "your-solution-name",
     "version-string": "1.0.0",
     "dependencies": [
       {
         "name": "fmt",
         "version": "9.1.0"
       },
       {
         "name": "zlib",
         "version": "1.2.13"
       }
     ]
   }
   

2. 在解决方案根目录创建Directory.Build.props，全局注入vcpkg配置，彻底避免逐项目配置：

   <Project>
     <PropertyGroup>
       <!-- 启用vcpkg解决方案级集成 -->
       <VcpkgEnabled>true</VcpkgEnabled>
       <!-- 指定vcpkg根目录（若不是默认路径则取消注释） -->
       <!-- <VcpkgRoot>$(SolutionDir)vcpkg</VcpkgRoot> -->
       <!-- 统一设置编译三元组，按需修改 -->
       <VcpkgTriplet>x64-windows</VcpkgTriplet>
     </PropertyGroup>
     <!-- 自动引入vcpkg目标文件 -->
     <Import Project="$(VcpkgRoot)\scripts\buildsystems\msbuild\vcpkg.targets" Condition="Exists('$(VcpkgRoot)\scripts\buildsystems\msbuild\vcpkg.targets')" />
   </Project>
   

   所有子项目会自动继承这个配置，无需逐个添加vcpkg引用。

步骤2：迁移NuGet依赖至PackageReference #

1. 批量替换packages.config：
   • 在VS中右键解决方案 → 管理解决方案的NuGet程序包
   • 切换到已安装标签，选中所有内部NuGet包，点击迁移，VS会自动将packages.config替换为项目文件中的PackageReference
2. 在Directory.Build.props中统一配置私有NuGet源：

   <Project>
     <!-- 保留之前的vcpkg配置 -->
     ...
     <PropertyGroup>
       <!-- 配置私有NuGet源 -->
       <RestoreSources>https://api.nuget.org/v3/index.json;https://你的私有NuGet源地址/v3/index.json</RestoreSources>
     </PropertyGroup>
   </Project>
   

3. （可选）创建根目录NuGet.Config，强制版本统一：

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
     <packageSources>
       <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
       <add key="private-source" value="https://你的私有NuGet源地址/v3/index.json" />
     </packageSources>
     <packageVersionPolicy>
       <!-- 强制所有项目使用完全一致的包版本 -->
       <dependencyVersion>exact</dependencyVersion>
     </packageVersionPolicy>
   </configuration>
   

步骤3：实现依赖版本强锁定 #

1. vcpkg版本锁定：运行vcpkg install后，自动生成vcpkg.lock文件，提交到版本控制系统，确保所有开发者使用完全一致的第三方依赖版本。
2. NuGet版本锁定：所有项目迁移至PackageReference后，执行dotnet restore会生成packages.lock.json文件，提交该文件强制所有项目使用锁定的内部NuGet包版本。

步骤4：优化依赖构建缓存 #

vcpkg默认会在全局目录（如%USERPROFILE%\vcpkg\installed）缓存已构建的依赖，所有项目共用同一缓存，无需重复构建。如果需要解决方案级缓存，可修改vcpkg.json：

{
  "name": "your-solution-name",
  "version-string": "1.0.0",
  "dependencies": [...],
  "install-root": "$(SolutionDir)vcpkg_installed" // 指定解决方案级安装目录
}

同时在Directory.Build.props同步设置：

<PropertyGroup>
  <VcpkgInstalledDir>$(SolutionDir)vcpkg_installed</VcpkgInstalledDir>
</PropertyGroup>

验证与注意事项 #

• 所有子项目无需单独配置vcpkg或NuGet依赖，自动继承解决方案级配置
• 若个别项目有特殊依赖需求，可在项目文件中单独添加（但尽量保持统一）
• 确保所有开发者使用同一版本的vcpkg，可在解决方案根目录添加vcpkg_version.txt记录使用的vcpkg提交哈希

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