Minimal APIs 是 C# 中一种用于构建轻量级 Web API 的简洁方式，首次在 .NET 6 中正式引入。它让开发者无需依赖复杂的项目结构或大量配置代码，就能快速创建 HTTP 服务。特别适合小型服务、微服务或原型开发。
什么是 Minimal APIs？
Minimal APIs 允许你在 Program.cs 文件中直接定义路由和处理逻辑，省去了传统 ASP.NET Core 中的控制器（Controller）、启动类（Startup）等冗余结构。整个 API 只需几行代码即可运行。
它基于 ASP.NET Core 的底层功能，但使用更简单的语法，完全支持依赖注入、中间件、模型绑定、验证和 OpenAPI（Swagger）等功能。
如何创建一个 Minimal API？
使用 .NET 6 或更高版本，可以通过以下步骤快速搭建：
1. 创建项目运行命令：
dotnet new web -n MyApi
2. 查看 Program.cs
你会看到非常简洁的代码：
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", () => "Hello World!");
app.Run();
这段代码就创建了一个响应根路径 GET 请求的 API。
3. 添加更多路由
你可以轻松扩展 API 接口：
app.MapGet("/user/{id}", (int id) => $"User {id}");
app.MapPost("/save", (UserData data) => Results.Ok("Saved"));
其中 UserData 会自动绑定请求体（JSON），并支持验证。
支持的功能有哪些？
尽管叫“Minimal”，但它并不“简陋”。以下是常用功能支持情况：
路由：支持 GET、POST、PUT、DELETE 等方法，带参数绑定 模型绑定：自动从 JSON、表单、查询字符串中解析数据 验证：可结合 Data Annotations 或 FluentValidation 依赖注入：可通过 builder.Services.Add... 注册服务 中间件：如认证、CORS、日志等均可通过 app.Use... 添加 OpenAPI 支持：集成 Swashbuckle 后自动生成文档适合用在哪些场景？
Minimal APIs 特别适合：
构建小型 REST 接口或内部工具 API 微服务架构中的独立小服务 学习 ASP.NET Core 或快速验证想法 函数式风格的服务，减少样板代码如果你需要复杂分层、大量控制器或高度结构化设计，传统 MVC 模式可能仍更合适。
基本上就这些。Minimal APIs 让 C# 开发轻量级后端变得更简单、更直观。不复杂但容易忽略细节，比如绑定规则或错误处理，用好它能大幅提升开发效率。
