# webapi教程-24级

**Repository Path**: myhfw003/webapi-tutorial-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**: 2
- **Created**: 2026-05-31
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# .NET 8 Web API 实践教程

面向**高职软件技术专业学生**的 .NET 8 后端开发实践教程，以**电商平台 API** 为主线，从环境搭建到生产部署，完整走一遍现代后端开发流程。

## 教程简介

本教程以项目迭代方式组织，每章在上一章的基础上递进完善，最终构建出一个包含商品、分类、用户、订单模块的完整电商后端 API。

## 技术栈

| 项目 | 选型 |
|------|------|
| IDE | VS Code + C# Dev Kit + Claude 扩展 |
| 框架 | .NET 8 Web API（Controller-based） |
| 数据库 | SQLite（开发）/ PostgreSQL（生产） |
| ORM | Entity Framework Core |
| 认证 | JWT Bearer Token |
| 验证 | FluentValidation |
| 日志 | Serilog |
| 文档 | Swagger / Scalar |
| 部署 | Debian + Nginx + pm2 |

## 目录

| 章节 | 标题 | 核心内容 |
|------|------|----------|
| [第 0 章](./第0章-环境搭建与AI编程入门/) | 环境搭建与 AI 编程入门 | SDK 安装、VS Code 配置、Claude 扩展、AI 辅助编程方法 |
| [第 1 章](./第1章-C#快速回顾/) | C# 快速回顾 | 类与对象、接口、泛型、LINQ、async/await |
| [第 2 章](./第2章-第一个WebAPI/) | 第一个 Web API | 项目结构、Controller、路由、配置管理、Swagger |
| [第 3 章](./第3章-EFCore与数据库/) | EF Core 与数据库 | Code First、实体关系、迁移、Seed 数据、SQLite → PostgreSQL |
| 第 4 章 | 分层架构 | Repository + Service + 依赖注入 |
| 第 5 章 | 数据验证与统一响应 | FluentValidation、统一返回格式、全局异常、分页 |
| [第 6 章](./第6章-身份认证与授权/) | 身份认证与授权 | 用户注册登录、BCrypt、JWT、角色权限 |
| [第 7 章](./第7章-订单与业务逻辑/) | 订单与业务逻辑 | 购物车、下单、库存扣减、事务 |
| 第 8 章 | 日志与部署 | Serilog、环境变量、Debian 部署、Nginx、pm2 |

## 前置要求

- 已学过 C# 基础语法（变量、条件、循环、类）
- 了解基本的 HTTP 概念（请求/响应、GET/POST 等）
- 安装了 .NET 8 SDK 和 VS Code（详见第 0 章）

## 如何使用本教程

1. **按顺序阅读**：每章依赖前一章的代码，不建议跳章
2. **动手实践**：每节都有"动手实践"部分，跟着做比只看效果好 10 倍
3. **善用 AI**：遇到不理解的代码，用 Claude 提问——但先自己思考，再问 AI
4. **完成练习**：每章末尾有巩固练习和挑战练习，做完才算真正掌握

## 项目迭代路线

```
第 0 章  工具就绪，学会用 AI 辅助编程
  ↓
第 1 章  C# 基础夯实
  ↓
第 2 章  能跑通第一个接口
  ↓
第 3 章  数据能持久化，模型关系清晰
  ↓
第 4 章  代码结构清晰（商品 CRUD 完整）
  ↓
第 5 章  接口健壮（验证 + 错误处理 + 分页）
  ↓
第 6 章  有用户体系（注册 / 登录 / 权限）
  ↓
第 7 章  核心业务完整（购物车 + 下单流程）
  ↓
第 8 章  可上线运行
```