.NET 兼容性

所有主要 IDE 在针对 net462、net472 和 net48 版本时都支持 Fern 生成的 SDK：

• Visual Studio 2022（推荐）- 开箱即用。在项目中设置 <LangVersion> 并安装相应的开发者包。
• Visual Studio 2019 - 原生支持 C# 9。对于更新的 C# 版本，添加 Microsoft.Net.Compilers.Toolset 包。
• Rider - 使用 Roslyn。设置 <LangVersion> 并确保引用程序集可用。
• VS Code - 通过 OmniSharp 和 .NET SDK 构建工作。
• Unity - 使用 Unity 自己的 C# 编译器。请参阅在 Unity 中使用 SDK。

使用 Visual Studio 2022+ 或 .NET SDK 附带的 Roslyn 编译器（csc）。通过 <LangVersion> 设置您的 C# 版本为 latest、preview 或特定版本（最低 9）。

Fern 的 .NET SDK 不支持传统的 Mono 编译器（mcs、gmcs）或 Roslyn 之前的 csc.exe 编译器。即使在 Mono 上构建也请使用 Roslyn。

$
dotnet build -c Release

• .NET Framework 4.6.2 开发者包
• .NET Framework 4.7.2 开发者包
• .NET Framework 4.8 开发者包

Unity 使用 Roslyn 编译项目，通常支持 C# 9（因 Unity 版本而异）。您无法通过更改包来强制 Unity 使用更新的 C# 编译器，因为 Unity 在编辑器内部控制编译器。

在 Unity 中配置：Edit → Project Settings → Player → Other Settings → Api Compatibility Level

• .NET Standard 2.1（推荐用于跨平台插件）
• .NET Framework 4.x（Unity 的”4.x 等效”配置文件）

Unity 不支持 NuGet 包，因此您必须手动下载这些程序集并将其添加到您的 Unity 项目：

使用现代 C# 针对 net48

1
<Project Sdk="Microsoft.NET.Sdk">
2
  <PropertyGroup>
3
    <!-- 目标 .NET Framework 4.8 -->
4
    <TargetFramework>net48</TargetFramework>
5
6
    <!-- 使用现代 C# 版本 -->
7
    <LangVersion>latest</LangVersion>
8
9
    <!-- 可选，但推荐用于更好的警告 -->
10
    <Nullable>enable</Nullable>
11
  </PropertyGroup>
12
</Project>

$
dotnet build -c Release

1
<TargetFrameworks>net48;net8.0</TargetFrameworks>

对于较旧的 MSBuild/Visual Studio 版本、Visual Studio 2019 或传统的 packages.config 设置，添加现代 Roslyn 工具集并针对旧框架。

1
<PropertyGroup>
2
<!-- 解锁现代 C# -->
3
<LangVersion>latest</LangVersion>
4
</PropertyGroup>

1
 <ItemGroup>
2
 <PackageReference Include="Microsoft.Net.Compilers.Toolset" Version="x.y.z">
3
     <!-- 保持私有： -->
4
     <PrivateAssets>all</PrivateAssets>
5
 </PackageReference>
6
 </ItemGroup>

在您的项目中添加一个小垫片或引用一个辅助包。

• Windows：安装 .NET Framework 4.8 开发者包。
• 跨平台/CI：将 Microsoft.NETFramework.ReferenceAssemblies 添加到项目中（作为 PrivateAssets=all）。

将 Microsoft.Net.Compilers.Toolset 添加到项目中，或迁移到 VS 2022+。

这个错误发生在较旧的 Visual Studio 版本中使用 required 关键字时。请按照传统项目的说明添加现代编译器。