VSCode无法正常加载Unity C#项目，转换SDK后遇API缺失问题

问题情况 #

用微软官方的Unity扩展给VSCode装了C#、C# Dev Kit这些必要扩展后，一开始遇到项目加载失败：提示Assembly-CSharp.csproj是传统.NET Framework格式，不被C# Dev Kit支持，得转成SDK风格项目。

手动在.csproj顶部加了这段代码完成转换：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net472</TargetFramework>
  </PropertyGroup>
</Project>

转换后项目能加载了，但又出现新问题：像System.Math.PI这类基础API找不到，报错误'System.Math' does not contain a definition for 'PI' CS0117。

问题原因 #

直接替换成纯SDK风格配置会把Unity自动生成的项目配置全覆盖掉——Unity的.csproj里包含了大量针对Unity运行时的程序集引用、编译路径、框架适配设置，这些被删掉后，VSCode的C# Dev Kit找不到Unity专属的.NET Framework API环境，导致基础类库的引用出问题。

解决步骤 #

1. 先恢复Unity自动生成的原始项目文件
   如果之前备份过.csproj直接用备份；没备份的话，打开Unity编辑器，依次点Edit > Preferences > External Tools，确认外部编辑器选的是VSCode，然后点击Regenerate project files，让Unity重新生成完整的项目配置文件。

2. 在原始配置基础上修改为SDK风格
   打开重新生成的Assembly-CSharp.csproj，在文件最开头的<?xml version="1.0" encoding="utf-8"?>之后，添加SDK声明，同时保留所有Unity自动生成的配置节点（比如PropertyGroup里的Unity专属属性、ItemGroup里的程序集引用和代码编译项）。

   示例修改后的结构：

   <?xml version="1.0" encoding="utf-8"?>
   <Project Sdk="Microsoft.NET.Sdk">
     <!-- 保留Unity原有的PropertyGroup，同时补充TargetFramework -->
     <PropertyGroup>
       <TargetFramework>net472</TargetFramework>
       <!-- 以下是Unity自动生成的属性，不要删除 -->
       <LangVersion>latest</LangVersion>
       <Nullable>enable</Nullable>
       <OutputPath>Temp\bin\Debug\</OutputPath>
       <BaseDirectory>.</BaseDirectory>
       <!-- 其他Unity生成的属性... -->
     </PropertyGroup>
   
     <!-- 保留Unity自动生成的程序集引用 -->
     <ItemGroup>
       <Reference Include="UnityEngine.CoreModule">
         <HintPath>$(UnityEnginePath)\UnityEngine.CoreModule.dll</HintPath>
       </Reference>
       <!-- 其他Unity相关引用... -->
     </ItemGroup>
   
     <!-- 保留Unity的代码编译项 -->
     <ItemGroup>
       <Compile Include="Assets\**\*.cs" />
     </ItemGroup>
   </Project>
   

3. 验证修复效果
   保存修改后的.csproj文件，重启VSCode，等待C# Dev Kit重新加载项目。加载完成后检查错误面板，System.Math.PI这类API的错误应该会消失。

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