【.NET新特性·第14篇】.NET 10 运行时与 SDK 新特性

JIT 优化、异步 ZIP、WebSocketStream、JSON 严格模式------.NET 10 让运行时和 SDK 更加强大

版本定位

适用版本：.NET 10 前置知识：.NET 9 基础

背景

.NET 10 的运行时和 SDK 带来了多项重要改进，包括 异步 ZIP API 、WebSocketStream 、JSON 严格模式 、Tensor 稳定化 、JIT/GC 引擎 API 改进等。这些改进覆盖了 I/O、网络、序列化、AI 计算等多个领域。

新特性一览

特性	简述	实用性
异步 ZIP API	ZipFile/ZipArchive 异步方法	⭐⭐⭐⭐⭐
WebSocketStream	WebSocket 流式读写	⭐⭐⭐⭐⭐
JSON Strict Mode	严格反序列化模式	⭐⭐⭐⭐
Tensor<T> 稳定化	AI 计算基块正式稳定	⭐⭐⭐⭐⭐
引擎 API 改进	JIT/GC 可编程接口	⭐⭐⭐⭐
改进的锁实现	Lock 语义优化	⭐⭐⭐
内存诊断工具改进	dotnet-dump 增强	⭐⭐⭐
AVX10.2 支持	新一代 SIMD 指令集	⭐⭐⭐⭐
控制台容器化	无需 Dockerfile	⭐⭐⭐⭐
CLI 内省	dotnet --cli-schema	⭐⭐⭐
包体积缩减改进	Trimming 更智能	⭐⭐⭐⭐

运行时新特性

1. 异步 ZIP API

之前的做法：ZIP 操作只有同步方法

// .NET 9 及之前
using var archive = ZipFile.OpenRead("data.zip");
foreach (var entry in archive.Entries)
{
    using var stream = entry.Open();
    using var reader = new StreamReader(stream);
    var content = reader.ReadToEnd();  // 同步阻塞
}

.NET 10 的做法：异步 ZIP API

// .NET 10 --- ZipFile 异步方法
await using var stream = File.OpenRead("data.zip");
await using var archive = new ZipArchive(stream, ZipArchiveMode.Read);

foreach (var entry in archive.Entries)
{
    await using var entryStream = entry.Open();
    using var reader = new StreamReader(entryStream);
    var content = await reader.ReadToEndAsync();
}

// .NET 10 --- 异步创建 ZIP
await using var outputStream = File.Create("output.zip");
await using var archive = new ZipArchive(outputStream, ZipArchiveMode.Create);

var textEntry = archive.CreateEntry("readme.txt");
await using var writer = new StreamWriter(textEntry.Open());
await writer.WriteAsync("Hello, World!");

// .NET 10 --- ZipFile 静态异步方法
await ZipFile.CreateFromDirectoryAsync("./myFolder", "backup.zip");
await ZipFile.ExtractToDirectoryAsync("backup.zip", "./output");

改进前后对比：

操作	.NET 9	.NET 10
打开 ZIP	ZipFile.OpenRead()	await ZipFile.OpenReadAsync()
创建 ZIP	ZipFile.CreateFromDirectory()	await ZipFile.CreateFromDirectoryAsync()
提取 ZIP	ZipFile.ExtractToDirectory()	await ZipFile.ExtractToDirectoryAsync()
读取条目	同步 entry.Open()	异步 entry.Open()

2. WebSocketStream

之前的做法：WebSocket 读写需要手动管理缓冲区

// .NET 9 及之前
var buffer = new byte[4096];
var result = await webSocket.ReceiveAsync(buffer, CancellationToken.None);
// 手动拼接消息、处理分片...

.NET 10 的做法：WebSocketStream 将 WebSocket 包装为 Stream

// .NET 10 --- WebSocketStream
await using var wsStream = new WebSocketStream(webSocket);

// 像普通 Stream 一样使用
using var reader = new StreamReader(wsStream);
var message = await reader.ReadToEndAsync();

// 或者用 Stream.CopyToAsync
await using var fileStream = File.Create("received.dat");
await wsStream.CopyToAsync(fileStream);

// 配合 HttpClient 使用
var httpClient = new HttpClient();
await httpClient.PostAsync("https://example.com/upload", wsStream);

使用场景：

// 实时数据流处理
await using var wsStream = new WebSocketStream(webSocket);
await using var reader = new BinaryReader(wsStream);

while (true)
{
    var data = reader.ReadBytes(1024);
    if (data.Length == 0) break;

    // 处理数据
    await ProcessDataAsync(data);
}

// 配合 Pipeline
var pipelineReader = new PipeReader();
await pipelineReader.CopyToAsync(wsStream);

3. JSON Strict Mode

之前的做法 ：System.Text.Json 默认忽略未映射的成员

// .NET 9 及之前
var options = new JsonSerializerOptions
{
    PropertyNameCaseInsensitive = true
};

var user = JsonSerializer.Deserialize<User>(json, options);
// 如果 JSON 中有 User 类没有的属性，静默忽略

.NET 10 的做法：严格模式拒绝未知属性

// .NET 10 --- Strict Mode
var options = new JsonSerializerOptions
{
    PropertyNameCaseInsensitive = true,
    UnmappedMemberHandling = JsonUnmappedMemberHandling.Disallow
};

try
{
    var user = JsonSerializer.Deserialize<User>(json, options);
}
catch (JsonException ex)
{
    // 包含未知属性时抛出异常
    Console.WriteLine($"JSON 包含未映射的属性: {ex.Message}");
}

// 或者使用 [JsonUnmappedMemberHandling] 特性
[JsonUnmappedMemberHandling(JsonUnmappedMemberHandling.Disallow)]
public class User
{
    public string Name { get; set; }
    public int Age { get; set; }
}

适用场景：

// API 响应验证 --- 确保 API 响应结构与模型匹配
var strictOptions = new JsonSerializerOptions
{
    PropertyNameCaseInsensitive = true,
    UnmappedMemberHandling = JsonUnmappedMemberHandling.Disallow
};

// 配置文件验证 --- 确保配置文件没有拼写错误的键
var config = JsonSerializer.Deserialize<AppSettings>(
    File.ReadAllText("appsettings.json"), strictOptions);

// 测试断言 --- 确保 API 返回的 JSON 结构符合预期
[Fact]
public void ApiResponse_HasExpectedStructure()
{
    var response = JsonSerializer.Deserialize<ApiResponse>(json, strictOptions);
    Assert.NotNull(response);
}

4. Tensor<T> 稳定化

之前的做法：Tensor 处于实验阶段

// .NET 9 --- 实验性 API
// 需要 opt-in

.NET 10 的做法：Tensor 正式稳定

// .NET 10 --- Tensor<T> 正式稳定
using System.Numerics.Tensors;

// 创建张量
var tensor = Tensor.Create<float>([2, 3]);
tensor[0, 0] = 1.0f;
tensor[0, 1] = 2.0f;
tensor[0, 2] = 3.0f;
tensor[1, 0] = 4.0f;
tensor[1, 1] = 5.0f;
tensor[1, 2] = 6.0f;

// 张量运算
var result = Tensor.Add(tensor, tensor);  // 逐元素加法
var product = Tensor.Multiply(tensor, 2.0f);  // 标量乘法

// 余弦相似度
float[] embedding1 = [0.1f, 0.2f, 0.3f];
float[] embedding2 = [0.4f, 0.5f, 0.6f];
var similarity = Tensor.CosineSimilarity(embedding1, embedding2);

配合 ML.NET 使用：

// AI 推理管道
var pipeline = mlContext.Transforms
    .Concatenate("Features", "embedding1", "embedding2")
    .Append(mlContext.BinaryClassification.Trainers.SdcaLogisticRegression());

// Tensor<T> 作为中间表示
var inputTensor = Tensor.Create<float>([1, embeddingSize]);
// ... 填充数据

5. 引擎 API 改进

.NET 10 提供了更强大的 JIT/GC 可编程接口：

// JIT 编译回调
// 可以在 JIT 编译前后注入自定义逻辑

// GC 改进
// 更好的大对象堆（LOH）管理
// 减少 GC 暂停时间

// 编译器优化
// 更好的内联决策
// 更好的循环优化
// 更好的向量化

方法虚化消除：

// 编译器可以消除不必要的虚方法调用
public class Processor
{
    public virtual void Process() { /* ... */ }
}

// 当类型是密封的或只有一种实现时
public sealed class ConcreteProcessor : Processor
{
    public override void Process() { /* ... */ }
}
// 编译器优化为直接调用，减少虚方法开销

6. 改进的锁实现

// .NET 10 改进了 Lock 类型的语义
using System.Threading;

// Lock 现在提供更好的性能特征
private readonly Lock _lock = new();

public void CriticalSection()
{
    lock (_lock)
    {
        // 改进的锁实现
        // 更低的争用开销
        // 更好的公平性
    }
}

7. 内存诊断工具改进

# dotnet-dump 增强
dotnet-dump collect -p <PID>

# .NET 10 改进：
# - 更好的 GC 堆分析
# - 更详细的对象引用跟踪
# - 改进的内存泄漏诊断

# dotnet-counters 改进
dotnet-counters monitor -p <PID>

# 新增的计数器：
# - 更详细的 JIT 编译统计
# - 更详细的 GC 代际统计
# - 更详细的线程池统计

8. AVX10.2 支持

// AVX10.2 是新一代 SIMD 指令集
// .NET 10 原生支持

using System.Numerics;
using System.Numerics.Tensors;

// 自动使用 AVX10.2 指令
var vector1 = Vector256.Create(1.0f, 2.0f, 3.0f, 4.0f);
var vector2 = Vector256.Create(5.0f, 6.0f, 7.0f, 8.0f);
var result = Vector256.Add(vector1, vector2);

// 张量运算自动利用 AVX10.2
var tensor1 = Tensor.Create<float>([1024]);
var tensor2 = Tensor.Create<float>([1024]);
var sum = Tensor.Add(tensor1, tensor2);

SDK 新特性

1. 控制台应用容器化

<!-- 控制台应用也可以生成容器镜像 -->
<PropertyGroup>
    <EnableDocker>true</EnableDocker>
    <DockerBaseImage>mcr.microsoft.com/dotnet/runtime-deps:10.0</DockerBaseImage>
</PropertyGroup>

# 生成容器镜像
dotnet publish --os linux --arch x64 /t:PublishContainer

优势：

• 无需 Dockerfile

• 自动优化镜像大小

• 支持多阶段构建

2. 包体积缩减改进

<!-- .NET 10 改进了 Trimming 分析 -->
<PropertyGroup>
    <PublishTrimmed>true</PublishTrimmed>
    <EnableTrimAnalyzer>true</EnableTrimAnalyzer>
</PropertyGroup>

改进点：

• 更智能的未使用代码检测

• 更好的反射代码修剪

• 更准确的警告信息

• 支持更多第三方库的 trim 兼容性

3. 平台特定的 .NET 工具

# 安装平台特定的工具
dotnet tool install --tool-path ./tools --runtime win-x64 my-tool

# 工具只在特定平台运行
./tools/my-tool.exe --arg1 value1

4. 一次性工具执行

# 不需要安装，直接执行
dotnet tool exec my-tool -- arg1 arg2

# 指定版本
dotnet tool exec my-tool@1.0.0 -- arg1 arg2

5. CLI 内省

# 获取 CLI 的 schema
dotnet --cli-schema

# 输出 JSON 栽式的 schema
# 可用于自动补全、文档生成、IDE 集成

6. .NET Aspire 9 改进

// Aspire 9 改进
// - Aspire Dashboard 增强
// - 更好的 Azure/AWS 集成
// - Redis 作为 LLM 缓存
// - 更好的模板支持

// Aspire Dashboard 新功能
// - 实时日志聚合
// - 分布式追踪
// - 资源健康检查
// - 自定义仪表板

7. 测试框架改进

# .NET 10 测试框架改进
dotnet test --filter "Category=Integration"

# 改进点：
# - 更快的测试发现
# - 更好的并行测试支持
# - 更准确的测试结果报告
# - 更好的代码覆盖率分析

8. 调试器改进

# .NET 10 调试器改进
# - 更快的启动时间
# - 更好的异步调试支持
# - 更好的 LINQ 表达式查看
# - 更好的集合查看器
# - 改进的热重载支持

实战场景

异步 ZIP API 适合的场景

// 大文件压缩
public async Task CompressLogsAsync(string sourceDir, string outputPath)
{
    await ZipFile.CreateFromDirectoryAsync(sourceDir, outputPath,
        CompressionLevel.Optimal,
        includeBaseDirectory: true);
}

// 流式解压
public async Task ExtractLargeZipAsync(string zipPath, string targetDir)
{
    await using var stream = File.OpenRead(zipPath);
    await using var archive = new ZipArchive(stream, ZipArchiveMode.Read);

    foreach (var entry in archive.Entries)
    {
        var entryPath = Path.Combine(targetDir, entry.FullName);
        Directory.CreateDirectory(Path.GetDirectoryName(entryPath)!);

        await using var entryStream = entry.Open();
        await using var fileStream = File.Create(entryPath);
        await entryStream.CopyToAsync(fileStream);
    }
}

WebSocketStream 适合的场景

// 实时日志流
public async Task StreamLogsAsync(WebSocket webSocket, string logFilePath)
{
    await using var wsStream = new WebSocketStream(webSocket);
    await using var logStream = File.Create(logFilePath);

    var buffer = new byte[4096];
    int bytesRead;
    while ((bytesRead = await wsStream.ReadAsync(buffer)) > 0)
    {
        await logStream.WriteAsync(buffer.AsMemory(0, bytesRead));
    }
}

// 实时文件传输
public async Task SendFileAsync(WebSocket webSocket, string filePath)
{
    await using var wsStream = new WebSocketStream(webSocket);
    await using var fileStream = File.OpenRead(filePath);
    await fileStream.CopyToAsync(wsStream);
}

迁移建议

从 .NET 9 升级

# 1. 更新 SDK 版本
dotnet --list-sdks

# 2. 更新项目文件
<TargetFramework>net10.0</TargetFramework>

# 3. 更新 NuGet 包
dotnet list package --outdated

# 4. 测试
dotnet test

注意事项

1. JSON Strict Mode：现有代码如果依赖忽略未知属性的行为，需要评估是否启用

2. WebSocketStream：需要 .NET 10 运行时

3. **Tensor<T>**：从实验性 API 升级到稳定 API，命名空间可能有变化

4. NativeAOT：不是所有 API 都支持 AOT，需要测试兼容性

一句话总结

.NET 10 运行时和 SDK 的改进，让异步 I/O、网络通信、JSON 处理和 AI 计算都更上一层楼。

---

官方文档

• What's new in .NET 10 runtime

• What's new in the .NET 10 SDK

• Native AOT deployment

• System.IO.Compression

• System.Net.WebSockets

• System.Text.Json

---

📦 示例代码：.NET 新特性巡礼全系列配套示例代码（含 dotnet 8/9/10）

• GitHub：GitHub - LadyKiller1025/dotnet-feature-tour-demos: .NET Feature Tour - Code Demos (.NET 8/9/10) · GitHub

• Gitee：https://gitee.com/qakjhzx/dotnet-feature-tour-demos

💬 欢迎点赞、收藏、转发，你的支持是我持续创作的动力！