📝 更新Python文档，增强标准库推荐与内容

- 在多个文档中增加了对标准库的详细说明

Author: jiangyangcreate

docs/docs/选择编程语言/Python/10函数.mdx

@@ -356,7 +356,7 @@ list(map(add, a, b))  # [12, 14, 19]
 ## 标准库推荐
 
 - functools: 提供高阶函数和装饰器工具，例如 `wraps`、`lru_cache` 等。
-- contextlib: 提供上下文管理器相关工具，如 `contextmanager`、`nullcontext`。
 - itertools: 提供迭代器工具（排列组合、无限迭代器等）。
 - operator: 提供将运算符函数化的工具，便于与高阶函数搭配使用。
-- typing: 提供类型提示支持，让函数签名更清晰。
+- typing: 提供类型提示支持，让函数签名更清晰。
+- doctest: 支持在文档字符串中编写示例代码，并自动执行这些示例以验证函数行为，非常适合为函数写“可执行文档”和简单测试。 

docs/docs/选择编程语言/Python/1变量.mdx

@@ -385,8 +385,5 @@ print(hash(a),hash(b))
 
 ## 标准库推荐
 
-- builtins: 内置函数与常用类型的集合，例如 `id`、`hash` 等。
-- keyword: 提供 Python 关键字列表，用于变量命名检查等场景。
 - hashlib: 提供多种安全哈希和摘要算法。
-- typing: 提供类型提示相关的类与工具，让代码更易于维护。
-- pydantic: <Highlight color="g">**第三方**数据验证与设置管理库，常用于配置与数据模型校验。</Highlight>
+- secrets: 提供安全随机数和令牌生成。

docs/docs/选择编程语言/Python/20类与对象.mdx

@@ -587,8 +587,29 @@ graph TD
 | **对象** | ✖️ | ✔️ |
 | **可迭代对象** | ✔️ | ✖️ |
 | 是**可迭代对象**也是**迭代器** | ✔️ | ✔️ |
+
+迭代器协议是 Python 中的核心概念之一。它定义了对象如何支持迭代操作，使得 for 循环、列表推导式等语法成为可能。迭代器提供了一种惰性求值的方式，节省内存并提高效率。
+
+```python showLineNumbers
+# 迭代器使得这些操作成为可能
+for item in [1, 2, 3]:
+    print(item)
+
+# 列表推导式也依赖于迭代器
+squares = [x**2 for x in range(10)]
+```
+
+[PEP 234 – 迭代器](https://peps.python.org/pep-0234/)
 :::
 
+迭代器是一个可以记住遍历位置的对象。迭代器对象从集合的第一个元素开始访问，直到所有元素被访问完结束。
+
+**迭代器的特点：**
+- **单向性**：只能往前不会后退
+- **惰性求值**：按需生成数据，节省内存
+- **一次性**：耗尽后不能重用，需要重新创建
+- **协议支持**：实现了 `__iter__()` 和 `__next__()` 方法
+
 ```python showLineNumbers
 class MyRange:
     def __init__(self, start, end):
@@ -626,6 +647,45 @@ __next__
 """
 ```
 
+```python showLineNumbers
+# 字符串、列表、元组都是可迭代对象，可用于创建迭代器
+lists = [1, 2, 3, 4]
+it = iter(lists)    # 创建迭代器对象
+
+print(next(it))  # 1 - 输出迭代器的下一个元素
+print(next(it))  # 2 - 再输出下一个元素
+print(next(it))  # 3
+print(next(it))  # 4
+
+# 耗尽后会抛出 StopIteration 异常
+try:
+    print(next(it))
+except StopIteration:
+    print("迭代器已耗尽")
+```
+
+:::tip
+for 循环会自动处理 StopIteration 异常，所以我们不需要手动捕获：
+```python
+lists = [1, 2, 3]
+for item in lists:  # for 循环内部调用 iter() 和 next()
+    print(item)
+```
+:::
+
+:::tip
+实际开发中，生成器（generator）通常比自定义迭代器类更简洁。生成器使用 `yield` 关键字。
+```python
+def countdown(start):
+    while start > 0:
+        yield start
+        start -= 1
+
+for num in countdown(5):
+    print(num)  # 5, 4, 3, 2, 1
+```
+:::
+
 
 ###  \_\_enter\_\_和\_\_exit\_\_ 与 with 语句
 
@@ -1493,10 +1553,55 @@ test_vars()
 print("Global vars keys:", list(vars().keys()))  # 显示全局变量的键
 ```
 
+### iter函数
+
+`iter()` 函数用于从可迭代对象创建迭代器，或创建一个调用函数直到返回哨兵值的迭代器。调用的是类的`__iter__()`方法。
+
+**函数签名：**
+1. `iter(iterable) -> iterator`
+2. `iter(callable, sentinel) -> iterator`
+
+```python showLineNumbers
+# 基本用法：从可迭代对象创建迭代器
+numbers = [1, 2, 3, 4, 5]
+it = iter(numbers)
+print(next(it))  # 1
+print(next(it))  # 2
+
+# 高级用法：使用哨兵值
+# 读取文件直到空行
+with open('data.txt') as f:
+    for line in iter(f.readline, '\n'):
+        print(line.strip())
+```
+
+### next函数
+
+`next()` 函数用于从迭代器获取下一个元素。调用的是类的`__next__()`方法。
 
-## 元类编程
+**函数签名：** `next(iterator, default=None) -> value`
+
+```python showLineNumbers
+# 基本用法
+numbers = iter([1, 2, 3])
+print(next(numbers))  # 1
+print(next(numbers))  # 2
+print(next(numbers))  # 3
+
+# 使用默认值避免 StopIteration 异常
+print(next(numbers, 'No more items'))  # No more items
+
+# 不使用默认值会抛出异常
+try:
+    numbers2 = iter([1, 2])
+    next(numbers2)
+    next(numbers2)
+    next(numbers2)  # 抛出 StopIteration
+except StopIteration:
+    print("迭代器已耗尽")
+```
 
-### object
+### object函数
 
 `object` 是 Python 中所有类的最终基类。在 Python 3 中，即使没有显式继承，所有类都会自动继承自 `object`。<Highlight>object 自己没有基类，它是根基类。</Highlight>
 
@@ -1549,5 +1654,6 @@ print(MyMetaClass.class_id)  # MyMetaClass_ID
 
 ## 标准库推荐
 
+- abc: 提供抽象基类支持，用于定义接口与抽象方法。
 - dataclasses: 通过装饰器自动生成 `__init__`、`__repr__` 等方法，简化数据类定义。
-- abc: 提供抽象基类支持，用于定义接口与抽象方法。
+- contextlib: 提供上下文管理器相关工具，如 `contextmanager`、`nullcontext`。

docs/docs/选择编程语言/Python/25迭代器.mdx

@@ -457,3 +457,9 @@ globals()["a"] = 99
 print("a =", a)  # 99
 ```
 
+## 标准库推荐
+
+- builtins: 内置函数与常用类型的集合，例如 `id`、`hash` 等。
+- gc: 控制和调试垃圾回收器（GC），可以查看、调整引用计数与循环引用的回收行为，常用于分析内存泄漏。
+- inspect: 提供运行时反射能力，能获取函数签名、源码、调用栈等信息，是调试装饰器、动态生成函数时的利器。
+- sys: 暴露解释器级别的接口（如 `sys.modules`、`sys.path`、`sys.getsizeof` 等），便于查看模块加载、内存占用与运行环境信息。