ASP.NET Core Minimal APIs 是从 .NET 6 开始引入的轻量级 Web API 开发方式，仅需少量代码即可定义 HTTP 接口，无需控制器和复杂结构，适合原型开发、微服务及简单后端。
想快速搭建一个轻量级的Web API？ASP.NET Core Minimal APIs 是个理想选择。它从 .NET 6 开始引入，让你用极少的代码定义 HTTP 接口，无需控制器或复杂的项目结构。适合原型开发、微服务或简单后端接口。
创建 Minimal API 项目
打开终端，运行以下命令创建新项目：
dotnet new web -n MyMinimalApicd MyMinimalApi
dotnet run
这会生成一个极简的 ASP.NET Core 项目，包含一个 Program.cs 文件，没有 Controllers 文件夹。默认代码已实现一个返回 "Hello World!" 的 GET 接口。
定义基本路由和HTTP方法
Minimal APIs 使用委托来处理请求，直接在 WebApplication 实例上注册路由。例如：
- GET 请求：获取数据
- POST 请求：接收 JSON 数据 app.MapPost("/data", (User user) => Results.Ok($"Received: {user.Name}"));
- PUT/DELETE：更新或删除资源 app.MapPut("/user/{id}", (int id, User user) => Results.NoContent());
- Results.Ok(data)：返回 200 和数据
- Results.NotFound()：返回 404
- Results.BadRequest()：返回 400
- Results.Created(path, data)：返回 201 和创建的资源
其中 User 是一个简单的类：
record User(string Name, int Age);app.MapDelete("/user/{id}", (int id) => Results.Ok($"Deleted user {id}"));
返回不同响应类型
使用 Results 静态类可以方便地返回标准 HTTP 响应：
示例：
app.MapGet("/users/{id}", (int id) =>{
if (id == 1) return Results.Ok(new User("Alice", 30));
return Results.NotFound();
});
启用跨域和添加Swagger
开发中常需 Swagger 查看接口和跨域支持。在 Program.cs 添加：
builder.Services.AddEndpointsApiExplorer();builder.Services.AddSwaggerGen();
并在中间件中启用：
if (app.Environment.IsDevelopment()){
app.UseSwagger();
app.UseSwaggerUI();
}
访问 https://localhost:5001/swagger 即可查看 API 文档。
基本上就这些。Minimal APIs 把简洁做到了极致，适合快速交付小功能。随着需求增长，也可以逐步引入依赖注入、验证、日志等特性。不复杂但容易忽略细节，比如模型绑定和错误处理，后续可按需扩展。
