本文详细介绍如何使用C#和ASP.NET Core从零开始构建一个功能完整的RESTful Web API，涵盖项目创建、控制器设计、数据模型定义、路由配置及API测试等核心环节，适合初学者快速上手。

在现代软件开发中，前后端分离架构已成为主流，而REST API作为前后端通信的桥梁，其重要性不言而喻。对于C#开发者而言，ASP.NET Core 提供了一套强大且高效的工具来构建高性能、跨平台的Web API。本文将带你一步步使用 ASP.NET Core 创建一个简单的 REST API，帮助你掌握核心概念并快速进入实战。

首先，确保你的开发环境中已安装 .NET SDK（推荐使用 .NET 6 或更高版本）。打开终端或命令行工具，执行以下命令创建一个新的 Web API 项目：

bash dotnet new webapi -n MyFirstApi cd MyFirstApi

该命令会生成一个包含基础结构的 ASP.NET Core Web API 项目。项目中的 Program.cs 文件是应用的入口点，它通过最小化配置启动了Web主机，并自动注册了必要的服务，如路由、控制器和Swagger文档支持。

接下来，我们创建一个简单的数据模型。假设我们要管理一个“产品”资源，可以在项目根目录下新建一个 Models 文件夹，并添加 Product.cs 类：

csharp public class Product { public int Id { get; set; } public string Name { get; set; } = string.Empty; pubic decimal Price { get; set; } }

模型定义完成后，我们需要创建一个控制器来处理HTTP请求。在 Controllers 文件夹中新建 ProductsController.cs，并继承自 ControllerBase：

csharp
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
private static readonly List _products = new()
{
new Product { Id = 1, Name = "笔记本电脑", Price = 5999 },
new Product { Id = 2, Name = "无线鼠标", Price = 199 }
};

[HttpGet]
public ActionResult<IEnumerable<Product>> Get()
{
    return _products;
}

[HttpGet("{id}")]
public ActionResult<Product> GetById(int id)
{
    var product = _products.FirstOrDefault(p => p.Id == id);
    if (product == null) return NotFound();
    return product;
}

[HttpPost]
public ActionResult<Product> Create(Product product)
{
    product.Id = _products.Max(p => p.Id) + 1;
    _products.Add(product);
    return CreatedAtAction(nameof(GetById), new { id = product.Id }, product);
}

[HttpPut("{id}")]
public IActionResult Update(int id, Product product)
{
    var existing = _products.FirstOrDefault(p => p.Id == id);
    if (existing == null) return NotFound();

    existing.Name = product.Name;
    existing.Price = product.Price;

    return NoContent();
}

[HttpDelete("{id}")]
public IActionResult Delete(int id)
{
    var product = _products.FirstOrDefault(p => p.Id == id);
    if (product == null) return NotFound();

    _products.Remove(product);
    return NoContent();
}

}

上述代码中，我们使用 [ApiController] 特性启用API专用行为，如自动模型验证；通过 [Route] 定义统一前缀；并实现了标准的 CRUD 操作：GET（获取）、POST（创建）、PUT（更新）和 DELETE（删除）。

为了便于调试和文档查看，ASP.NET Core 内置了 Swagger（在项目模板中称为“OpenAPI”）。运行项目后，浏览器访问 /swagger 路径即可看到自动生成的API文档界面，你可以直接在页面上测试各个接口，查看请求和响应结构。

此外，ASP.NET Core 支持依赖注入、配置管理、日志记录等企业级特性。例如，后续可将 _products 列表替换为真正的数据库上下文（如 Entity Framework Core），并通过服务注册实现解耦。

最后，发布API时可使用 dotnet publish 命令生成独立部署包，也可容器化部署到 Docker 或云平台如 Azure、AWS 等。

ASP.NET Core 凭借其高性能、模块化设计和丰富的生态，正成为C#开发者构建现代Web服务的首选框架。掌握其Web API开发流程，不仅能提升开发效率，也为构建复杂分布式系统打下坚实基础。