ASP.NET Core 主机模型：Host、WebHost 与 WebApplication 怎么选

Host 更像底座，不绑定 HTTP 场景。做后台任务、Worker Service、控制台程序时，它更合适。它不自带 Web 服务器，所以如果你要的是 API 或站点，单靠它还不够。

WebApplication：现在的新默认

var builder = WebApplication.CreateBuilder(args);
// 添加服务到容器
builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// 配置 HTTP 请求管道
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();
app.Run();

这套写法把以前分散在 Program 和 Startup 里的东西收拢到一起了。代码短很多，读起来也直接。对新项目来说，默认选它通常没什么争议，尤其是要上最小 API 的时候。

什么时候用哪个

这个选择其实不复杂：你只要先判断是不是 Web 项目，再看是不是新项目。新项目别再从 WebHost 起步了，后面再改回来只会多一次迁移成本。

从 WebHost 迁到 WebApplication

旧项目常见结构是这样：

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllers();
    }

    public void Configure(IApplicationBuilder app)
    {
        app.UseRouting();
        app.UseEndpoints(endpoints => endpoints.MapControllers());
    }
}

换成 WebApplication 后，很多地方能直接合并掉：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();

迁移时最大的变化不是 API 名字，而是组织方式。以前你习惯把配置塞进 Startup，现在更多是直接在 Program.cs 里顺着读下去。小项目很舒服，大项目如果没有约定，Program.cs 也可能长得乱，所以别把'更短'误解成'更适合所有团队'。

最小 API 的写法

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", () => "Hello World!");
app.MapGet("/user/{id}", (int id) => $"User ID: {id}");
app.Run();

这个模式适合快速起一个轻量 API。路由清楚，样板代码也少。要是项目本身就不复杂，用它会比传统 MVC 管线省很多事。

常见几个问题

WebApplication 和 Host 能一起用吗？

能。WebApplication 本身就是建立在 Host 之上的，只是把 Web 场景常用的那部分封装好了。

还需要单独的 Startup 类吗？

不需要。WebApplication 模型下，Program.cs 就能完成大部分配置。不过如果项目很大，继续拆分到别的文件里也没问题，关键是团队要统一风格。

性能差很多吗？

启动上 WebApplication 通常更省事，也更少一层包装；真正运行起来，差异通常没那么戏剧化。对大多数业务系统来说，架构清晰比'快一点点'更重要。

结尾

这三个模型不是平行竞争关系，而是 ASP.NET Core 这几年演进出来的不同层次。Host 是基础，WebHost 是旧时代的 Web 写法，WebApplication 则是现在更顺手的入口。新项目直接用 WebApplication，老项目按节奏迁，别为了'统一风格'把一次性改造做成风险放大器。