Skip to content

ASP.NET Core 第一步从第一个接口到上线

写给有编程经验、但没碰过 C# 的你。基于 .NET 10 与 Minimal API,一步只学一个概念,每一章都是能直接 dotnet run 的完整项目。

三十秒预览

一个完整的 Web API,只有 17 行 ​

这就是第 02 章结束时你会写出的程序:一个返回 JSON 的接口,外加自动生成的交互式 API 文档。没有配置文件要改,没有样板类要继承。

  1. 创建项目一条 dotnet new web 命令得到一个最小的 Web 项目
  2. 声明端点MapGet 把 URL 和一个普通函数连起来,返回值自动序列化为 JSON
  3. 运行dotnet watch 启动服务,改代码后自动热重载
  4. 打开文档访问 /scalar,在浏览器里直接调试你的接口
Program.cs
cs
using Scalar.AspNetCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddOpenApi();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.MapOpenApi();
    app.MapScalarApiReference();
}

app.MapGet("/", () => new { Message = "Hello, ASP.NET Core!" });

app.Run();

学习路线

六个阶段,一条主线 ​

后面的章节依赖前面的内容:EF Core 要用到依赖注入,认证要用到中间件。所以教程是一条线性主线,建议按顺序阅读。

共 6 个阶段、24 章,已完成 24 章。

  1. 入门

    装好工具,认识 C#,跑起第一个接口

  2. 应用骨架

    让应用可配置、可观测,组件之间松耦合

  3. 数据访问

    用 EF Core 把数据存进 SQLite,组合成完整的 API

  4. 安全

    先确认"你是谁",再决定"你能做什么"

  5. 上线

    测试、整理代码结构,然后发布出去

基于 .NET 10 与 Minimal API · 所有示例均可直接 dotnet run