Minimal API怎么用 .NET 6 Minimal API入门教程

Minimal API 是 .NET 6 引入的极简 Web API 开发方式，无需 Controller 和类库结构，几行代码即可运行接口服务，适用于原型开发、微服务及轻量后台。

Minimal API 是 .NET 6 引入的极简 Web API 开发方式，不用写 Controller、不用定义类库结构，几行代码就能跑起一个可访问的接口服务。它适合快速验证逻辑、搭建微服务、做原型或轻量后台。

创建 Minimal API 项目

用 CLI 最快：打开终端，执行

dotnet new web -n MyApi
cd MyApi
dotnet run

项目默认监听 http://localhost:5000 和 https://localhost:5001，浏览器打开就能看到 “Hello World!”。

注意：新建时别勾选 “Use Controllers”，否则会生成传统 Web API 模板。

定义基础路由和响应

打开 Program.cs，你会看到类似这样的结构：

var app = WebApplication.Create(args);
app.MapGet("/", () => "Hello World!");
app.Run();

常用方法有：

• MapGet：处理 GET 请求（如获取数据）
• MapPost：处理 POST 请求（如提交 JSON）
• MapPut / MapDelete：对应更新和删除

参数自动绑定规则：

• 简单类型（string、int、Guid等）→ 默认从 query 或 route 获取
• 复杂类型（如 User 类）→ 默认从 request body 解析 JSON
• 想强制指定来源？加特性，比如 [FromQuery]、[FromBody]、[FromRoute]

接入依赖注入和服务

Minimal API 完全支持 .NET 的 DI 容器。先在 builder.Services 中注册服务，再在 handler 中通过参数注入：

标签： js json 浏览器 app 路由 .net