Visual Studio构建时创建Symlink而非复制引用程序集

方案1：使用内置MSBuild属性 #

对于.NET Core/.NET 5+项目，以及Visual Studio 2019及以上版本，可直接在项目文件（.csproj/.vbproj）中添加配置，让VS自动用符号链接替代本地复制：

<PropertyGroup>
  <UseSymlinksForCopyLocalIfPossible>true</UseSymlinksForCopyLocalIfPossible>
</PropertyGroup>

当引用的程序集位于本地磁盘、且当前系统支持符号链接时，VS会自动创建符号链接到输出目录，而非复制文件。

方案2：自定义MSBuild目标（灵活适配场景） #

如果内置属性无法满足需求，可通过自定义MSBuild目标替换默认复制逻辑，在项目文件中添加以下内容：

<Target Name="ReplaceCopyWithSymlink" AfterTargets="ResolveAssemblyReferences">
  <!-- 禁用默认的本地复制行为 -->
  <ItemGroup>
    <ReferenceCopyLocalPaths>
      <Visible>false</Visible>
    </ReferenceCopyLocalPaths>
    <!-- 筛选需要创建符号链接的引用程序集 -->
    <SymlinkCandidates Include="@(ReferenceCopyLocalPaths)" Condition="!Exists('$(OutDir)%(Filename)%(Extension)')" />
  </ItemGroup>

  <!-- 为候选程序集创建符号链接 -->
  <CreateSymbolicLink
      Condition="@(SymlinkCandidates) != ''"
      Link="$(OutDir)%(SymlinkCandidates.Filename)%(SymlinkCandidates.Extension)"
      Target="%(SymlinkCandidates.FullPath)"
      HardLink="false"
  />
</Target>

关键注意事项 #

• 系统权限：Windows下创建符号链接需启用开发者模式，或以管理员身份运行Visual Studio；Linux/macOS无需特殊权限即可创建。
• 兼容性：确保使用的Visual Studio版本支持CreateSymbolicLink任务，推荐VS2019及以上版本。
• 调试影响：符号链接不会干扰调试流程，Visual Studio可正常加载程序集符号文件并调试。

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