ASP.NET Core 创建 Web API 的核心是 Controller + [ApiController] + 模型绑定 + 内置 JSON 序列化；需新建项目、添加带特性的控制器、可选配置 JSON 和 CORS。
ASP.NET Core 创建 Web API 很简单，核心是用 Controller + [ApiController] 特性 + 模型绑定 + 内置 JSON 序列化，不需要额外装包（.NET 6+ 默认内置）。
1. 新建 ASP.NET Core Web API 项目
用 CLI 或 Visual Studio 都行，推荐命令行快速启动：
- dotnet new webapi -n MyApi —— 创建带 WeatherForecast 示例的模板
-
cd MyApi && dotnet run —— 启动后访问
https://localhost:5001/weatherforecast就能看到默认 API
注意：.NET 6+ 模板默认启用 minimal hosting 模式（Program.cs 里一行 builder.Build()），但 Controller 方式仍完全支持，无需改写。
2. 添加自己的 API Controller
右键项目 → 添加 → 新建控制器 → 选择 “API Controller with actions, using Entity Framework”（如果连数据库）或 “API Controller – Empty”（纯接口）。
- 给类加上
[ApiController]和[Route("api/[controller]")] - 方法用 HTTP 方法特性标记，比如
[HttpGet]、[HttpPost] - 返回类型建议用
IActionResult或具体模型（如Task），框架会自动序列化为 JSON>
示例：
[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
[HttpGet]
public IActionResult Get() => Ok(new[] { new { Id = 1, Name = "Laptop" } });
[HttpPost]
public IActionResult Create([FromBody] Product product)
{
// 处理逻辑
return CreatedAtAction(nameof(Get), new { id = 1 }, product);
}
}
3. 启用并配置 JSON 序列化（可选但常用）
.NET 6+ 默认用 System.Text.Json，若需兼容旧习惯（如驼峰命名、忽略 null 值），在 Program.cs 中配置：
- builder.Services.AddControllers().AddJsonOptions(opt => { opt.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase; });
- 如需支持循环引用或 DateTime 格式控制，也可在这里设
ReferenceHandler或Converters
4. 启用 CORS（跨域调试时必需）
- 在
Program.cs中添加服务：builder.Services.AddCors(); - 在中间件中启用：app.UseCors(policy => policy.AllowAnyOrigin().AllowAnyMethod().AllowAnyHeader());
- 生产环境请替换
AllowAnyOrigin()为具体域名
基本上就这些。不复杂但容易忽略路由匹配、模型绑定失败静默返回 400、以及没开 CORS 导致前端收不到响应——检查这几个点，API 就能稳稳跑起来。
