如何在MSBuild内联任务中使用.NET 6方法跨平台创建文件符号链接？

报错原因 #

你遇到的CS0117错误，是因为MSBuild内联任务默认使用的编译环境基于.NET Framework，而System.IO.File.CreateSymbolicLink是.NET Core 3.0及以上版本才新增的API，默认环境无法识别该方法。

方案一：修改内联任务编译环境适配.NET 9 #

通过指定Roslyn任务工厂和目标框架，让内联任务使用.NET 9的API：

<UsingTask TaskName="CreateSymbolicLinkTask" TaskFactory="RoslynCodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll">
  <ParameterGroup>
    <SourceFile Required="true" ParameterType="System.String" />
    <DestinationLink Required="true" ParameterType="System.String" />
  </ParameterGroup>
  <Task>
    <Using Namespace="System.IO" />
    <Code Type="Fragment" Language="cs">
      <![CDATA[
        File.CreateSymbolicLink(DestinationLink, SourceFile);
      ]]>
    </Code>
    <Reference Include="System.IO.FileSystem" />
    <PropertyGroup>
      <TargetFramework>net9.0</TargetFramework>
      <LangVersion>latest</LangVersion>
    </PropertyGroup>
  </Task>
</UsingTask>

使用时在目标中调用该任务即可：

<Target Name="PreBuildCreateLinks" BeforeTargets="Build">
  <CreateSymbolicLinkTask SourceFile="你的源文件路径" DestinationLink="你的链接路径" />
</Target>

关键配置说明 #

• TaskFactory="RoslynCodeTaskFactory"：替换默认的CodeTaskFactory，支持.NET Core/.NET 5+的API
• <TargetFramework>net9.0</TargetFramework>：明确指定使用.NET 9框架编译内联代码
• <Reference Include="System.IO.FileSystem" />：确保引用包含File.CreateSymbolicLink的程序集

方案二：使用系统原生命令（更简单跨平台） #

直接调用Windows和Linux的原生命令创建符号链接，避免框架版本问题：

<Target Name="CreateSymbolicLinks" BeforeTargets="Build">
  <!-- Windows 创建文件符号链接，目录链接需加 /D 参数 -->
  <Exec Condition="$([MSBuild]::IsOSPlatform('Windows'))" 
        Command="mklink &quot;$(DestinationLink)&quot; &quot;$(SourceFile)&quot;" 
        IgnoreExitCode="false" />

  <!-- Linux 创建软链接 -->
  <Exec Condition="$([MSBuild]::IsOSPlatform('Linux'))" 
        Command="ln -s &quot;$(SourceFile)&quot; &quot;$(DestinationLink)&quot;" 
        IgnoreExitCode="false" />
</Target>

注意事项 #

• Windows下若创建目录符号链接，将命令改为mklink /D "目标路径" "源路径"
• Windows本地运行需确保VS以管理员权限启动（否则mklink会报错），GitHub Actions的Windows runner默认具备管理员权限
• Linux下ln -s自动适配文件/目录，无需额外参数

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