用途:在 ASP.NET Core 中设计并实现 Minimal APIs,采用处理程序优先的终结点写法,适合新建 HTTP API、轻量微服务、简单 CRUD 与 .NET 8+ 项目;已有 MVC/API 项目、复杂模型绑定、OData/JsonPatch 或重度依赖特性的场景更适合控制器。
主要能力:直接在 Program.cs 定义终结点;用 MapGroup 组织相关路由并共享配置(如 RequireAuthorization、WithTags);用 AddEndpointFilter 实现内联或类级过滤器处理验证、日志、错误等横切关注点;用 TypedResults 返回类型安全响应;用 WithOpenApi、WithName、WithSummary、Produces 生成 OpenAPI 文档。
使用方式:小型 API 在 Program.cs 中 app.MapGet/MapPost 等直接定义;随规模增长用扩展方法把处理程序移到独立类(如 MapProductEndpoints);用 DTO 隔离领域实体;验证可结合过滤器与 FluentValidation。
限制与注意:避免全部堆在 Program.cs、不用路由组、手工验证、直接暴露实体、不用 TypedResults、忽略 OpenAPI。上游 dotnet/aspnetcore v10.0.11 为维护版本,不改变路由组、过滤器或 TypedResults 模型,但 OpenAPI 栈更新至 2.7.5,升级后需重新生成文档与契约快照。具体安装命令与价格暂未提供。