目标框架

NuGet 在各种位置使用目标框架引用来专门标识和隔离包的依赖框架的组件：

• 项目文件：对于 SDK 样式的项目， .csproj 包含目标框架引用。
• .nuspec 清单：包可以指示项目中包含的不同包，具体取决于项目的目标框架。
• .nupkg 文件夹名称：包文件夹中的文件夹可以根据目标框架进行命名，每个文件夹 lib 都包含 DLL 和适合该框架的其他内容。
• packages.config： targetframework 依赖项的属性指定要安装的包的变体。

有关所有受支持的目标框架及其 TFM 语法的规范列表，请参阅 SDK 样式项目中的目标框架。

TargetFramework 值是别名

TargetFramework项目文件中的属性是一个友好名称（别名），可转换为规范框架标识。 .NET SDK 通过设置 TargetFrameworkMoniker （TFM）和属性（如果适用 TargetPlatformMoniker ）来执行此转换。

例如，编写 <TargetFramework>net10.0-windows</TargetFramework>时，.NET SDK 会将该 SDK 转换为：

• TargetFrameworkMoniker = .NETCoreApp,Version=v10.0
• TargetPlatformMoniker = Windows,Version=7.0

NuGet 使用这些名字对象属性（而不是 TargetFramework 字符串）进行包兼容性检查。 这意味着 TargetFramework 值本身可以是任何字符串，只要正确设置名字对象属性。 例如，以下项目有效：

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

  <PropertyGroup Condition=" '$(TargetFramework)' == 'banana' ">
    <TargetFrameworkIdentifier>.NETCoreApp</TargetFrameworkIdentifier>
    <TargetFrameworkVersion>v10.0</TargetFrameworkVersion>
    <TargetFrameworkMoniker>.NETCoreApp,Version=v10.0</TargetFrameworkMoniker>
  </PropertyGroup>
</Project>

即使值为 banana.NET 10.0，TargetFramework此项目也会还原和生成。 .NET SDK 已经依赖于这种特定于 OS 的 TTFM net8.0-iosnet8.0-android的别名机制，其中短 TFM 转换为具有平台信息的完整名字对象。

具有重复框架的多目标

从 NuGet 7.6 / .NET SDK 10.0.300 开始，多个 TargetFrameworks 别名可以解析为相同的有效框架。 这可实现多 RID 生成和多版本扩展目标等方案。 有关此操作如何适用于还原、打包、锁定文件和项目引用的详细信息，请参阅 面向多个框架。

支持的框架

框架通常由短目标框架名字对象或 TFM 引用。 在 .NET Standard 中， TxM 也通用化为允许对多个框架的单个引用。

NuGet 客户端支持下表中的框架。 等效项显示在方括号 [] 中。 请注意，某些工具（例如 dotnet）可能会在某些文件中使用规范 TPM 的变体。 例如，dotnet pack在文件中使用.NETCoreApp2.0，而不是 netcoreapp2.0.nuspec 。 各种 NuGet 客户端工具正确处理这些变体，但在直接编辑文件时，应始终使用规范 TPM。

弃用的框架

以下框架已弃用。 面向这些框架的包应迁移到指示的替换项。

Precedence

许多框架彼此相关且相互兼容，但不一定等效：

.NET 标准

.NET Standard 简化了二进制兼容框架之间的引用，允许单个目标框架引用其他框架的组合。 （有关背景信息，请参阅 .NET Primer。

NuGet 获取最近的框架工具模拟 NuGet 根据项目的框架从包中的多个可用框架资产中选择一个框架。

应在 dotnet NuGet 3.3 及更早版本中使用一系列名字对象; netstandard 名字对象语法应在 v3.4 及更高版本中使用。

可移植类库

若要定义引用多个子目标框架的目标框架，该 portable 关键字用于为引用框架列表添加前缀。 避免人为地包括不直接编译的额外框架，因为它可能会导致这些框架中的意外副作用。

第三方定义的其他框架提供与其他以这种方式访问的环境的兼容性。 此外，有一些简写配置文件编号可用于引用这些相关框架 Profile#的组合，但不建议使用这些数字，因为它减少了文件夹和的 .nuspec可读性。

此外，面向 Xamarin 的 NuGet 包可以使用其他 Xamarin 定义的框架：