如何为Visual Studio项目安装Microsoft.Build.CopyOnWrite优化DevDrive？

1. .NET Framework和.NET Core项目的安装方法 #

单个项目安装 #

不管是.NET Framework还是.NET Core项目，都可以通过Visual Studio的NuGet包管理器操作：

• 右键项目 → 选择“管理NuGet程序包”
• 在浏览页搜索Microsoft.Build.CopyOnWrite，找到后点击“安装”
• 确认弹窗中的项目选择，完成安装

用Directory.Packages.Props统一管理（推荐） #

如果解决方案包含多个项目，不想逐个安装，可以用这个文件统一控制包版本：

1. 在解决方案根目录新建名为Directory.Packages.Props的文件
2. 写入以下内容（替换版本号为实际最新版本）：

<Project>
  <PropertyGroup>
    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
  </PropertyGroup>
  <ItemGroup>
    <PackageVersion Include="Microsoft.Build.CopyOnWrite" Version="x.x.x" />
  </ItemGroup>
</Project>

3. 回到Visual Studio，给需要启用特性的项目的项目文件（.csproj/.vbproj）添加一行引用：

<PackageReference Include="Microsoft.Build.CopyOnWrite" />

后续所有项目会自动沿用统一配置的包版本，升级时只需修改Directory.Packages.Props里的版本号即可。

2. 是否需要添加到所有项目？额外操作说明 #

• 不需要强制添加到所有项目：只有那些构建时需要复制大量文件、希望利用DevDrive ReFS的CopyOnWrite特性优化构建速度的项目才需要添加，小体量项目加不加影响不大。
• 仅通过NuGet添加（或上述统一配置）即可：这个包基于MSBuild任务，安装后会自动注入构建逻辑，不需要额外修改脚本或系统设置。但前提是你的机器已经配置了Windows 11 DevDrive（ReFS文件系统），否则包不会生效。

3. 验证包是否正常工作 #

可以通过两种方式验证：

• 查看构建日志：
  1. 在Visual Studio中点击“生成” → “生成解决方案”
  2. 打开“输出”窗口，选择“生成”输出
  3. 搜索关键词CopyOnWrite，如果看到类似“Using CopyOnWrite to link file XXX to XXX”的日志，说明包已生效
• 检查文件属性：
  找到构建后复制到输出目录的文件，右键 → “属性” → 查看“详细信息”里的“链接类型”，如果显示为“Copy-on-Write”，说明该文件是通过CopyOnWrite链接创建的。也可以用命令行工具fsutil refs listcopyonwritelinks <文件路径>，如果返回该文件路径，说明是CopyOnWrite链接。

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