在 .NET 11 中用 System.Text.Json…

当目标框架为 net11.0 或更高，需要用内置 PascalCase 命名策略、强类型 JsonTypeInfo<T> 或无异常探测类型元数据时使用。

适用场景

解决思路

1. 确认目标框架为 net11.0 或更高：运行 `dotnet --list-sdks` 确认存在可面向 `net11.0` 的 SDK（11.x SDK，或带 net11.0 targeting pack 的更高版本 SDK）。
2. 若用户要求实际运行示例但缺少合适 SDK，使用官方 `dotnet-install` 脚本把当前 .NET 11 SDK 安装到临时或项目本地目录；优先 GA 频道，仅在 GA 尚未发布或用户明确要求预览版时使用 preview；不要要求管理员权限、不要修改机器级 `PATH`、不要替换已安装的 SDK。
3. 用本地安装的 `dotnet` 可执行文件运行示例；若下载或执行被阻止，仍提供完整的 `net11.0` 程序并说明未运行；绝不用 `net10.0`、自定义命名策略或其他 API 冒充对 .NET 11 特性的验证。
4. 安装 SDK 时使用频道而非猜测版本号：PowerShell 用 `& $installScript -Channel 11.0 -InstallDir .\.dotnet`，shell 用 `bash "$install_script" --channel 11.0 --install-dir ./.dotnet`；GA 之前重试时加 `-Quality preview`（PowerShell）或 `--quality preview`（shell）。
5. PascalCase 属性名：创建或复用 `JsonSerializerOptions` 并设置 `PropertyNamingPolicy = JsonNamingPolicy.PascalCase`，然后用该 options 序列化；不要写 `JsonNamingPolicy` 子类、不要为改大小写给每个成员加 `[JsonPropertyName("…")]`、不要手动把首字母大写。
6. PascalCase 字典键：设置 `DictionaryKeyPolicy = JsonNamingPolicy.PascalCase`；不要只设 `PropertyNamingPolicy`、不要预先转换字典、不要定义自定义策略。
7. 强类型元数据：设置 `TypeInfoResolver = new DefaultJsonTypeInfoResolver()`，然后调用 `JsonTypeInfo<T> ti = options.GetTypeInfo<T>();` 直接得到 `JsonTypeInfo<T>` 并赋值使用（如传给 `JsonSerializer.Serialize`/`Deserialize`）；不要调用非泛型 `GetTypeInfo(Type)` 再强转。
8. 无异常探测元数据：调用 `options.TryGetTypeInfo<T>(out var info)`，显式处理 `true` 分支（元数据已解析，使用 `info`）和 `false` 分支（未解析）；不要用 `try`/`catch` 包裹 `GetTypeInfo<T>()` 来检测缺失情况。
9. 注意 `GetTypeInfo<T>()` 需要解析器：除非 options 设置了 `TypeInfoResolver`，否则会抛 `NotSupportedException`（`NoMetadataForType`）；反射应用设 `TypeInfoResolver = new DefaultJsonTypeInfoResolver()`，裁剪/AOT 应用使用源生成的 `JsonSerializerContext`。
10. 产出可运行输出：优先使用控制台项目（反射序列化开箱即用），在 `.csproj` 中写 `<TargetFramework>net11.0</TargetFramework>`，代码放 `Program.cs`，运行 `dotnet run`，确认退出码为 0 且打印预期 JSON。
11. 若用文件式应用：保存为 `app.cs`，用 `#:property TargetFramework=net11.0` 固定框架，运行 `dotnet run app.cs`；注意文件式应用会禁用 System.Text.Json 反射（`JsonSerializer.IsReflectionEnabledByDefault` 为 `false`），必须在每个 `JsonSerializerOptions` 上设置 `TypeInfoResolver = new DefaultJsonTypeInfoResolver()` 或使用源生成的 `JsonSerializerContext`，否则普通序列化会抛 `NoMetadataForType`。
12. 完成前逐项核对验证清单：目标为 `net11.0`（`.csproj` 或 `#:property TargetFramework=net11.0` 可见）；PascalCase 请求使用 `JsonNamingPolicy.PascalCase` 且无自定义子类或仅为改大小写的 `[JsonPropertyName]`；字典键请求设置 `DictionaryKeyPolicy`；强类型元数据请求使用泛型 `GetTypeInfo<T>()` 且 options 设置了 `TypeInfoResolver`；探测请求使用 `TryGetTypeInfo<T>(out …)` 且无 `try`/`catch`；程序确实运行（`dotnet run …`）且退出码为 0、打印的 JSON 显示预期属性名（如 `"Name"`、`"Age"`）；若用文件式应用则每个 `JsonSerializerOptions` 都设置了 `TypeInfoResolver`。
13. 避免常见陷阱：不要为 PascalCase 手写 `class … : JsonNamingPolicy`；不要给每个成员加 `[JsonPropertyName("Name")]` 强制大小写；不要强转 `(JsonTypeInfo<T>)options.GetTypeInfo(typeof(T))`；不要用 `try`/`catch` 测试可用性；遇到 `NoMetadataForType` 时设置 `TypeInfoResolver`；文件式应用中出现 `NoMetadataForType` 时添加 `TypeInfoResolver = new DefaultJsonTypeInfoResolver()` 或改用普通项目；显式固定 `net11.0` 而非 SDK 默认 TFM；不要未运行就声称成功，要运行 `dotnet run` 并粘贴实际 JSON 输出。

适用边界 · 注意事项

• 目标框架早于 net11.0 时不要使用这些 API。
• 请求的行为使用 net11 之前已有的命名策略时不要使用。
• 用户明确选择了其他 JSON 库时不要使用。