Minimal API 是一种在 .NET 6 中引入的轻量级 HTTP 服务构建方式，1. 它通过简化路由和处理逻辑定义，无需控制器即可快速搭建 API；2. 核心优势包括减少样板代码、提升开发效率、降低学习成本、资源占用少且易于容器化；3. 支持与 ASP.NET Core 生态无缝集成，如依赖注入、中间件、日志和数据库；4. 可通过 dotnet new web 快速创建项目，并在 Program.cs 中使用 lambda 表达式定义 GET、POST 等路由；5. 内置 JSON 序列化支持，可轻松返回或接收对象数据；6. 能注册服务（如 DbContext、Singleton 服务）并在请求中直接注入使用；7. 适合微服务、原型开发等场景，虽简洁但仍可扩展验证、错误处理等机制。
Minimal API 是 C# 中一种简洁高效的方式来创建轻量级的 HTTP 服务，它从 .NET 6 开始成为默认项目模板的一部分。它的核心特点是用最少的代码定义路由和处理逻辑，无需控制器（Controller），特别适合构建小型服务、微服务或快速原型。
Minimal API 的核心优势
它去除了传统 ASP.NET Core MVC 中的冗余结构，比如控制器类、动作方法等，直接在 Program.cs 中通过简单的 lambda 表达式定义接口行为。这种方式减少了样板代码，提高了开发效率。
- 代码更少，启动更快
- 学习成本低，适合新手入门
- 资源占用小，适合容器化部署
- 与 ASP.NET Core 生态无缝集成（如依赖注入、中间件）
快速创建一个 Minimal API 项目
使用 .NET CLI 可以几秒内生成并运行一个基础 API。
- 打开终端，运行命令创建新项目：
dotnet new web -n MyApi - 进入项目目录：
cd MyApi - 运行项目：
dotnet run
此时会看到服务监听在 5000 和 5001 端口（HTTP/HTTPS），浏览器访问 https://www.php.cn/link/6060d322713797e84f598ea25c812cab 就能看到 "Hello World!"。
添加实际的 API 路由示例
修改 Program.cs 文件，添加几个常见类型的接口：
var builder = WebApplication.CreateBuilder(args);var app = builder.Build();
// 基础 GET 请求
app.MapGet("/hello", () => "Hello, Minimal API!");
// 带路径参数
app.MapGet("/user/{id}", (int id) => $"User ID: {id}");
// 返回 JSON 数据
app.MapGet("/api/users", () => new[] {
new { Id = 1, Name = "Alice" },
new { Id = 2, Name = "Bob" }
});
// POST 接收 JSON 输入
app.MapPost("/api/users", (User user) => Results.Created($"/api/users/{user.Id}", user));
app.Run();
record User(int Id, string Name);
这个例子展示了如何处理不同类型的请求，并自动序列化/反序列化 JSON 数据，得益于内置的 System.Text.Json 支持。
集成日志、数据库和其他服务
尽管轻量，Minimal API 仍可轻松接入完整功能。例如注册服务：
builder.Services.AddSingleton<IDataService, InMemoryDataService>();builder.Services.AddDbContext
options.UseSqlite("Data Source=app.db"));
然后在路由中通过参数获取服务实例：
app.MapGet("/data", (IDataService service) => service.GetData());基本上就这些。Minimal API 让你用最直接的方式暴露 HTTP 接口，不复杂但容易忽略细节，比如模型验证、错误处理等，可在需要时逐步增强。
