增加每章节 README 文件

2026-09-22 15:57:59 +08:00
parent 8e86665096
commit 9445061c76
49 changed files with 3815 additions and 6 deletions
@@ -0,0 +1,55 @@
+# Python 高级编程之基础巩固
+
+> 所属：阶段一 · 前置核心基础
+> 目标：巩固 Python 类型注解、dataclass、异常处理、上下文管理器等基础功底，是后续所有阶段的语言基座。
+
+---
+
+## 📌 学习目的
+
+巩固 Python 类型注解、dataclass、异常处理、上下文管理器等基础功底，是后续所有阶段的语言基座。
+
+## ✅ 学习要求（前置条件）
+
+已完成 Python 入门语法（变量 / 函数 / 类），能独立写 100 行左右的脚本。
+
+## 📚 主要学习内容
+
+- 类型注解：`typing` / `TypeAlias` / `NewType` / `Optional` / `Union`
+- `dataclass` 数据类（含 `field`、`frozen`、`post_init`）
+- 异常处理：`try/except/else/finally` + 异常链 `raise from` + 自定义异常层级
+- 上下文管理器：`with` 协议 / `@contextmanager` / `contextlib`
+- 模块与包：`__init__.py` 的语义 / 相对导入 / 命名空间包
+
+## 📖 对应 docs
+
+- 目录：[`docs/01-阶段一-前置核心基础/`](../../docs/01-阶段一-前置核心基础/)（按目录名里的 `第 X 篇` 对应）
+- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
+
+## 🛠️ 建议练习
+
+- [ ] 写一个支持嵌套的 `dataclass` 配置加载器（含默认值校验）
+- [ ] 实现可复用的计时 / 临时目录上下文管理器
+- [ ] 构造「连接池用完即抛」的自定义异常链路
+
+## 🏁 完成后达成标准
+
+- [ ] 能熟练使用类型注解与 dataclass 定义数据结构
+- [ ] 能用上下文管理器封装任意资源的获取与释放
+- [ ] 能写出层级清晰的自定义异常体系
+
+---
+
+## 🚀 运行提示
+
+```bash
+# 激活根目录的虚拟环境
+cd /Users/jack/source/Demo/py/demo_python_agent
+source .venv/bin/activate   # 或直接用 uv run ...
+
+# 进入本章目录
+cd code/001_phase1_foundations/01_python_advanced_basics
+
+# 跑你的练习文件
+uv run python your_exercise.py
+```