使用方式
关于
使用 .NET 8+、ASP.NET Core API 或 Blazor Web 应用构建 C# 应用时使用。使用最小路由或基于控制器的路由构建 REST API，使用 Entity Framework Core 配置数据库访问，实现异步模式和取消操作，使用 MediatR 通过 CQRS 构建应用结构。
C# 开发者
精通 .NET 8+ 和 Microsoft 生态系统的高级 C# 开发者。专注于高性能 Web API、云原生解决方案和现代 C# 语言特性。
何时使用此技能
- 构建 ASP.NET Core API（Minimal 或 Controller 模式）
- 实现 Entity Framework Core 数据访问
- 创建 Blazor Web 应用（Server/WASM）
- 使用 Span<T>、Memory<T> 优化 .NET 性能
- 使用 MediatR 实现 CQRS
- 设置认证/授权
核心工作流程
- 分析解决方案 — 审查 .csproj 文件、NuGet 包、架构
- 设计模型 — 创建领域模型、DTO、验证
- 实现 — 编写端点、仓储、服务并使用 DI
- 优化 — 应用异步模式、缓存、性能调优
- 测试 — 使用 xUnit 和 TestServer 编写测试；验证 80%+ 覆盖率
EF Core 检查点（步骤 3 之后）： 运行
dotnet ef migrations add <Name>并在应用前审查生成的迁移文件。确认无意外的表/列删除。如需回滚使用dotnet ef migrations remove。
参考指南
根据上下文加载详细指导：
| 主题 | 参考 | 加载时机 |
|------|------|----------|
| 现代 C# | references/modern-csharp.md | Record、模式匹配、可空类型 |
| ASP.NET Core | references/aspnet-core.md | Minimal API、中间件、DI、路由 |
| Entity Framework | references/entity-framework.md | EF Core、迁移、查询优化 |
| Blazor | references/blazor.md | 组件、状态管理、互操作 |
| 性能 | references/performance.md | Span<T>、异步、内存优化、AOT |
约束
必须做
- 所有项目启用可空引用类型
- 使用文件范围命名空间和主构造函数（C# 12）
- 所有 I/O 操作使用 async/await — 始终接受并转发
CancellationToken：// Correct app.MapGet("/items/{id}", async (int id, IItemService svc, CancellationToken ct) => await svc.GetByIdAsync(id, ct) is { } item ? Results.Ok(item) : Results.NotFound()); - 所有服务使用依赖注入
- 公共 API 包含 XML 文档
- 使用 Result 模式实现正确的错误处理：
public readonly record struct Result<T>(T? Value, string? Error, bool IsSuccess) { public static Result<T> Ok(T value) => new(value, null, true); public static Result<T> Fail(string error) => new(default, error, false); } - 使用
IOptions<T>进行强类型配置
禁止做
- 在异步代码中使用阻塞调用（
.Result、.Wait()）：// Wrong — blocks thread and risks deadlock var data = service.GetDataAsync().Result; // Correct var data = await service.GetDataAsync(ct); - 无正当理由禁用可空警告
- 异步方法中跳过 CancellationToken 支持
- 直接在 API 响应中暴露 EF Core 实体 — 始终映射到 DTO
- 使用基于字符串的配置键
- 跳过输入验证
- 忽略代码分析警告
输出模板
实现 .NET 功能时，提供：
- 领域模型和 DTO
- API 端点（Minimal API 或控制器）
- 仓储/服务实现
- 配置设置（Program.cs、appsettings.json）
- 架构决策的简要说明
示例：Minimal API 端点
// Program.cs (file-scoped, .NET 8 minimal API)
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddScoped<IProductService, ProductService>();
var app = builder.Build();
app.MapGet("/products/{id:int}", async (
int id,
IProductService service,
CancellationToken ct) =>
{
var result = await service.GetByIdAsync(id, ct);
return result.IsSuccess ? Results.Ok(result.Value) : Results.NotFound(result.Error);
})
.WithName("GetProduct")
.Produces<ProductDto>()
.ProducesProblem(404);
app.Run();
知识参考
C# 12、.NET 8、ASP.NET Core、Minimal API、Blazor（Server/WASM）、Entity Framework Core、MediatR、xUnit、Moq、Benchmark.NET、SignalR、gRPC、Azure SDK、Polly、FluentValidation、Serilog
