ASP.NET Core怎么创建API ASP.NET Core Web API入门方法

新闻中心 NEWS CENTER

2025-12-12

浏览次数：次

ASP.NET Core 创建 Web API 推荐新手从 Minimal API 入手，用 dotnet new web -n MyApi 创建轻量项目，几行代码即可定义路由与处理逻辑；中大型项目则宜采用 Controller 模式，通过特性标注实现规范分层与功能扩展。

asp.net core怎么创建api asp.net core web api入门方法

ASP.NET Core 创建 Web API 很简单，核心是用 Minimal API 或 Controller 模式 两种主流方式，推荐新手从 Minimal API 入手，代码少、逻辑直、上手快。

打开终端，执行一行命令即可生成一个纯净的 API 项目：

进入项目目录后运行 dotnet run，API 就在 https://localhost:5001 启动了。

在 Program.cs 里直接添加路由和处理逻辑，比如返回 JSON 数据：

添加 GET 接口：app.MapGet("/hello", () => new { Message = "Hello from ASP.NET Core!" });
支持参数：app.MapGet("/users/{id}", (int id) => new { Id = id, Name = $"User{id}" });
返回状态码：app.MapPost("/users", (User user) => Results.Created($"/users/{user.Id}", user));

不需要控制器类、不用配置路由属性，依赖注入和模型绑定自动可用。

Codeium

一个免费的AI代码自动完成和搜索工具

345 查看详情 Codeium

如果项目需要分层、复用、版本控制或 Swagger 文档，用 Controller 更规范：

默认已启用模型验证、绑定、格式化，开箱即用。

无论哪种方式，这几个点容易忽略但很关键：

确保 Program.cs 中调用了 builder.Services.AddControllers()（Controller 方式）或没禁用默认 JSON 支持
开发环境建议启用 Swagger：app.UseSwagger(); app.UseSwaggerUI();
跨域（CORS）若需前端调用，加 builder.Services.AddCors() 和中间件
JSON 序列化设置（如忽略 null 值、驼峰命名）可在 AddJsonOptions 中调整

基本上就这些，不复杂但容易忽略细节。跑通第一个 GET /hello 后，再逐步加 POST、数据库、认证，节奏就很稳了。

以上就是ASP.NET Core怎么创建API ASP.NET Core Web API入门方法的详细内容，更多请关注其它相关文章！