术语表
按主题排列。英文名尽量沿用 官方术语对照表；“课程”列指向详细讲解。
环境与运行
| 术语 | 英文 | 释义 | 课程 |
|---|---|---|---|
| 解释器 | interpreter | 执行 Python 代码的程序；官方实现为 CPython | 1.1 |
| 交互式解释器 | REPL | 逐行输入、立即求值的环境，提示符 >>> | 1.1 |
| 字节码 | bytecode | 源码编译后的中间表示，由解释器虚拟机执行 | 1.1 |
| 虚拟环境 | virtual environment | 项目专属的解释器链接 + 第三方包目录（.venv） | 1.2 |
| 锁文件 | lock file | 记录全部依赖精确版本的文件（uv.lock） | 1.2 |
| 包（分发） | distribution package | 可安装的发布单元，如 PyPI 上的 python-dotenv | 1.2 |
值与类型
| 术语 | 英文 | 释义 | 课程 |
|---|---|---|---|
| 对象 | object | 一切数据都是对象，有身份、类型和值 | 2.1 |
| 名字绑定 | name binding | 赋值把名字绑定到对象，变量本身无类型 | 2.1 |
| 动态类型 / 强类型 | dynamic / strong typing | 类型属于对象；不同类型不隐式转换 | 2.1 |
| 真值 | truthiness | 对象在条件判断中被视为真或假 | 2.2 |
| 可变 / 不可变 | mutable / immutable | 创建后能否原地修改（list 可变，str/tuple 不可变） | 4.1 |
| 可哈希 | hashable | 有固定哈希值，可作 dict 键或放入 set | 4.3 |
| 序列 | sequence | 支持整数索引与切片的有序容器（list、tuple、str） | 4.1 |
| 映射 | mapping | 键到值的容器（dict） | 4.2 |
| 浅拷贝 / 深拷贝 | shallow / deep copy | 只复制外层 / 递归复制全部 | 4.1 |
| f-string | formatted string literal | 前缀 f 的字符串，{} 内为表达式 | 2.4 |
函数与作用域
| 术语 | 英文 | 释义 | 课程 |
|---|---|---|---|
| 形参 / 实参 | parameter / argument | 定义中的名字 / 调用时传入的值 | 3.2 |
| 关键字参数 | keyword argument | 以 name=value 形式传入的实参 | 3.2 |
| 仅限关键字参数 | keyword-only parameter | 签名中 * 之后的参数，只能按名字传 | 3.3 |
| 解包 | unpacking | 调用时 *seq / **dict 展开；赋值时 a, b = ... | 3.3 |
| 一等函数 | first-class function | 函数是对象，可赋值、存储、传递 | 3.2 |
| 分发表 | dispatch table | “名字 → 函数”的 dict，替代长串 if/elif | 3.2 |
| 作用域 / LEGB | scope | 名字查找顺序：局部、外层、全局、内置 | 3.4 |
| 闭包 | closure | 捕获外层变量的内部函数 | 3.4 |
| lambda | lambda | 单表达式的匿名函数 | 3.4 |
| 装饰器 | decorator | 接收函数并返回替换对象的可调用对象，@ 语法 | 10.2 |
容器与迭代
| 术语 | 英文 | 释义 | 课程 |
|---|---|---|---|
| 推导式 | comprehension | [expr for x in xs if cond] 等构造容器的表达式 | 4.4 |
| 可迭代对象 | iterable | 能被 for 遍历的对象（实现 __iter__） | 10.1 |
| 迭代器 | iterator | 实现 __next__，逐个产出值，耗尽时抛 StopIteration | 10.1 |
| 生成器 | generator | 含 yield 的函数返回的惰性迭代器 | 10.1 |
| 生成器表达式 | generator expression | 圆括号形式的惰性推导式 | 4.4 |
模块与异常
| 术语 | 英文 | 释义 | 课程 |
|---|---|---|---|
| 模块 | module | 一个 .py 文件，导入后成为模块对象 | 5.1 |
| 包（导入） | package | 包含模块的目录；常规包含 __init__.py | 5.2 |
| 相对导入 | relative import | from .x import y，包内互相引用 | 5.2 |
| 回溯 | traceback | 异常发生时的调用栈报告，最近的调用在最后 | 6.1 |
| 异常链 | exception chaining | raise X from e 保留原始原因 | 6.2 |
| EAFP | easier to ask forgiveness than permission | 先执行、出错再处理的风格 | 6.2 |
| 上下文管理器 | context manager | 实现 __enter__/__exit__，配合 with 管理资源 | 6.3 |
类与类型注解
| 术语 | 英文 | 释义 | 课程 |
|---|---|---|---|
| 类 / 实例 | class / instance | 类是创建实例的模板；调用类得到实例 | 7.1 |
| 方法 | method | 定义在类中的函数，第一个参数为 self | 7.1 |
| 特殊方法 | special method / dunder | __xxx__ 形式的方法，支撑内置语法 | 7.2 |
| 方法解析顺序 | MRO | 查找属性/方法时依次搜索的类序列 | 7.2 |
| 数据类 | dataclass | 由字段声明自动生成常用方法的类 | 7.3 |
| 鸭子类型 | duck typing | 只看对象有没有所需的方法/属性，不看类型 | 9.2 |
| 类型注解 | type annotation / type hint | 标注预期类型，运行时不检查 | 9.1 |
| 泛型 | generic | 带类型参数的类型，如 list[str] | 9.2 |
| 哨兵值 | sentinel | 用于表示“未提供”等特殊状态的唯一对象 | 10.4 |
Agent 相关（本项目）
| 术语 | 释义 | 课程 |
|---|---|---|
| 工具调用（tool use） | 模型返回 tool_use 块请求调用工具，由本地代码执行并回传 tool_result | 11.1 |
stop_reason | 模型停止生成的原因；"tool_use" 表示在等待工具结果 | 11.1 |
| 内容块（content block） | 回复内容的组成单元：text、tool_use、thinking 等 | 9.2 |
input_schema | 用 JSON Schema 描述工具参数，供模型生成参数 | 8.2 |