99.1 知识点模板
用一句话说明这个知识点解决什么问题，以及它在 .NET 全栈开发中的位置。
学习目标
- 能解释这个知识点的核心概念。
- 能在一个真实业务场景中写出可运行代码。
- 能识别常见错误和调试方向。
应用场景
说明它通常出现在什么项目阶段，例如接口设计、数据建模、前端交互、认证授权、部署排障或性能优化。
核心概念
| 概念 | 说明 |
|---|---|
| 概念 A | 用简单语言解释，不堆术语 |
| 概念 B | 说明它和其他概念的关系 |
案例
用一个具体业务问题带出技术实现，例如“给任务列表增加完成状态并持久化到数据库”。
示例代码
public sealed record ExampleRequest(string Name);
app.MapPost("/examples", (ExampleRequest request) =>
{
return Results.Created($"/examples/{request.Name}", request);
});
重点难点
- 难点 1：说明为什么容易错。
- 难点 2：给出判断标准或调试方法。
常见误区
| 误区 | 推荐做法 |
|---|---|
| 只记 API 名称 | 结合输入、输出、边界条件理解 |
| 忽略失败路径 | 同时设计错误响应和日志 |
练习
- 修改示例需求，增加一个新字段和校验规则。
- 写一个失败用例，观察错误响应和日志。
延伸阅读
- Microsoft Learn 对应主题
- 官方 API 文档
- 项目实战中的对应章节