# webapi教程精简版-24级

**Repository Path**: myhfw003/webapi-tutorial-simplified-grade24

## Basic Information

- **Project Name**: webapi教程精简版-24级
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# .NET 8 Web API 实践教程 · 精简版

面向**高职软件技术专业、有 Web 基础的学生**，以**电商平台 API 为主线**（仅 Category + Product 两个实体），用约一周时间，从环境搭建到综合查询接口，完整走一遍 .NET 8 Web API 开发流程。

## 教程简介

本教程是 [webapi-tutorial-grade24](https://gitee.com/myhfw003/webapi-tutorial-grade24.git) 的**精简版**，原教程 9 章体量偏大，本教程砍掉认证、部署、复杂分层、订单事务等高级内容，聚焦"**一周内能跑通一个有持久化的、规范的 RESTful API**"这一目标。

每章在上一章的代码基础上迭代，最终构建出一个包含**商品分类**与**商品**的电商后端 API。

## 技术栈

| 项目 | 选型 |
|------|------|
| 框架 | .NET 8 Web API（Controller-based） |
| 数据库 | SQLite（单文件，零配置） |
| ORM | Entity Framework Core 8（Code First） |
| 文档 | Swagger / Scalar |
| IDE | VS Code + C# Dev Kit |

**不引入**：JWT、FluentValidation、Repository/Service 分层、部署与日志。

> 完整背景与要求见 [CLAUDE.md](./CLAUDE.md)。

## 目录

| 章节 | 标题 | 核心内容 |
|------|------|----------|
| [第 1 章](./第1章-环境与第一个WebAPI/) | 环境与第一个 Web API | .NET 8 SDK、VS Code、`dotnet new webapi`、最小 Controller、Swagger 调试 |
| [第 2 章](./第2章-EFCore与SQLite/) | EF Core 与 SQLite | NuGet、`AppDbContext`、Category+Product 实体、Code First 迁移、Seed 数据、CRUD 接 DbContext |
| [第 3 章](./第3章-RESTful规范与接口健壮性/) | RESTful 规范与接口健壮性 | REST 命名、状态码、`ApiResponse<T>`、DataAnnotations 验证、全局异常中间件、分页 |
| [第 4 章](./第4章-关联数据与综合业务/) | 关联数据与综合业务 | Category-Product 一对多、Include、复合查询（关键词+分类+价格+排序+分页）、聚合统计、Swagger 完善 |

## 前置要求

- C# 基础语法（类、接口、LINQ 可选）
- HTTP 基础（GET/POST/PUT/DELETE、状态码、JSON）
- SQL 基础（SELECT、WHERE、JOIN）
- 已安装 .NET 8 SDK、VS Code + C# Dev Kit

## 项目迭代路线

```
第 1 章  能跑通第一个接口（内存版 Categories）
   ↓
第 2 章  数据能持久化到 SQLite（Category + Product CRUD）
   ↓
第 3 章  接口符合 RESTful 规范且健壮（统一响应、验证、异常、分页）
   ↓
第 4 章  能处理实体关系和综合查询业务（一对多、筛选/排序/分页、聚合）
```

## 如何使用本教程

1. **按顺序阅读**：每章依赖前一章的代码，不建议跳章
2. **必须动手**：每节都有"动手实践"部分，跟着做比只看效果好 10 倍
3. **善用搜索引擎 / AI**：遇到不理解的 API，先查官方文档（[learn.microsoft.com](https://learn.microsoft.com/zh-cn/dotnet/)）再问 AI
4. **完成练习**：每章末尾有"回顾与练习"，做完才算真正掌握

## 章节内部结构

每章目录下文件命名约定：

```
第N章-XXX/
├── N.0-概述.md              # 本章目标、任务、内容索引
├── N.1-XXX.md               # 小节 1
├── N.2-XXX.md               # 小节 2
├── ...
└── N.X-回顾与练习.md        # 本章小结、巩固练习、挑战练习
```