1. 什么是 Carter？为什么需要它？

Carter 是一个轻量级、高性能的框架，专为在 ASP.NET Core 平台上构建 HTTP API 而设计。它深受流行的 NancyFX 框架启发，为开发者提供了熟悉的声明式路由和请求处理方式。与传统的 MVC（Model-View-Controller）模式不同，Carter 允许你直接在代码中定义端点（endpoints），无需创建单独的控制器或配置复杂的路由规则。

为什么要用 Carter？核心原因是开发简单、速度快。当你需要快速搭建一个最小化 API 或微服务时，Carter 提供了简洁的语法，能大幅减少样板代码。它非常适合那些不需要 MVC 全部功能，但又需要灵活处理请求和响应的项目。Carter 还能与 ASP.NET Core 无缝集成，充分利用其内置的依赖注入容器、中间件等特性。

Carter 的关键特性包括：自动绑定路由参数和请求体（model binding）、内置验证支持、简单的错误处理，以及轻松测试端点的能力。该框架由社区积极维护，并被许多公司用于生产环境。

2. 安装 Carter

要将 Carter 安装到你的 ASP.NET Core 项目中，请使用 NuGet 包管理器。在终端中执行以下任一命令：

dotnet add package Carter

或者通过 Visual Studio 的包管理器控制台：

Install-Package Carter

安装后，你需要在 Program.cs（或旧版本中的 Startup.cs）中注册 Carter：

using Carter;

var builder = WebApplication.CreateBuilder(args);

// 将 Carter 添加到依赖注入容器
builder.Services.AddCarter();

var app = builder.Build();

// 启用 Carter 中间件
app.MapCarter();

app.Run();

注意：在 .NET 6+ 的现代版本中，虽然已有最小 API，但 Carter 在处理更复杂的逻辑时仍然非常实用。

3. 快速上手——一个最小化工作示例

创建一个新的 ASP.NET Core 项目（空项目或 Web API 项目）。按上述步骤安装 Carter。然后创建一个实现 ICarterModule 接口的类：

using Carter;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Routing;

public class HomeModule : ICarterModule
{
    public void AddRoutes(IEndpointRouteBuilder app)
    {
        // 定义 GET 端点，路径为 "/"
        app.MapGet("/", () => "来自 Carter 的问候！");
        
        // 定义带参数的 GET 端点
        app.MapGet("/hello/{name}", (string name) => $"你好, {name}!");
    }
}

现在，在 Program.cs 中注册这个模块：

using Carter;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddCarter();
var app = builder.Build();
app.MapCarter();
app.Run();

启动应用程序，访问 http://localhost:5000/hello/World。你将看到响应：你好, World!。

4. 核心方法/函数/类

下面介绍 Carter 中你最常用的关键元素。

4.1. ICarterModule 接口

ICarterModule 是 Carter 的核心接口。你需要为每个逻辑分组（例如用户管理、商品管理）创建一个实现该接口的类。在 AddRoutes 方法中，你可以使用 IEndpointRouteBuilder 提供的扩展方法来定义各种 HTTP 方法的端点。