用途：在 ASP.NET Core 中构建或维护基于控制器的 Web API，适用于需要控制器约定、高级模型绑定、验证扩展、OData、JsonPatch 或现有过滤器的项目；若只是简单新 API，建议优先使用 Minimal APIs。
主要能力与工作流：保持控制器精简，把 HTTP 关注点映射到应用服务或处理器，避免在 action 中嵌入数据访问与业务规则；使用清晰的 DTO 边界、显式验证和可预测的 HTTP 状态行为；在控制器与端点两级审查认证授权；有意识地处理 OpenAPI 生成、版本控制和错误契约。
用法要点：可用 C# 12+ 主构造函数注入依赖，用 [ApiController]、[Route] 与 [ProducesResponseType] 声明契约；显式声明绑定来源，如 [FromRoute]、[FromQuery]、[FromHeader]；请求 DTO 可用 record 与 required 成员；复杂验证可用 FluentValidation，并通过 ApiBehaviorOptions 统一 Problem Details 响应；版本控制可配置 URL 路径版本；异常处理可用 IExceptionHandler 全局处理器。
限制与注意：资料未提供安装命令、收费或平台信息。上游说明提到 dotnet/aspnetcore v10.0.11 为服务更新，OpenAPI 栈更新至 2.7.5，升级后应重新运行生成文档与客户端契约检查；2026 年 8 月 aspnetcore-10.0 概览中控制器 API 与 Minimal APIs 并存，修改公共 API 契约前应查阅专门的路由、OpenAPI、认证与托管页面。需验证控制器特性确有理由、action 不隐藏业务逻辑与持久化细节、各端点 HTTP 语义保持一致。