C#的Minimal API是什么？如何快速创建轻量级的HTTP API？

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。

1. 打开终端，运行命令创建新项目：
   dotnet new web -n MyApi
2. 进入项目目录：
   cd MyApi
3. 运行项目：
   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();

PPT.CN,PPTCN,PPT.CN是什么,PPT.CN官网,PPT.CN如何使用

一键操作，智能生成专业级PPT

37

查看详情

record User(int Id, string Name);

这个例子展示了如何处理不同类型的请求，并自动序列化/反序列化 JSON 数据，得益于内置的 System.Text.Json 支持。

集成日志、数据库和其他服务

尽管轻量，Minimal API 仍可轻松接入完整功能。例如注册服务：

然后在路由中通过参数获取服务实例：

基本上就这些。Minimal API 让你用最直接的方式暴露 HTTP 接口，不复杂但容易忽略细节，比如模型验证、错误处理等，可在需要时逐步增强。

以上就是C#的Minimal API是什么？如何快速创建轻量级的HTTP API？的详细内容，更多请关注php中文网其它相关文章！