约束、默认值与枚举
安全地限制取值范围并提供固定选项。
约束、默认值与枚举 是 CoddyKit 上的免费 MCP Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 MCP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 MCP Academy 课程共包含 4 节课。
不只是类型
类型说明允许哪一类值，但您通常还需要更严格的规则：限制值必须为正数，名称不能为空。这正是约束发挥作用的地方。
认识字段
Pydantic 的字段功能允许您直接在模型定义中为字段附加规则，例如最小值和最大值。
from pydantic import BaseModel, Field
class Page(BaseModel):
size: int = Field(ge=1, le=100)数值范围
使用 ge 和 le 表示大于等于和小于等于，或使用 gt 和 lt 表示严格的范围限制，从而让数字保持在安全范围内。
字符串长度限制
对于文本，min_length 和 max_length 会在空字符串和过长输入到达您的逻辑之前将其拦截。
name: str = Field(min_length=1, max_length=50)模式匹配
添加模式，要求字符串匹配正则表达式，非常适合代码、路径标识或简单标识符。
简单的默认值
为字段提供一个值，它就会因具有默认值而变为可选字段。模型可以省略它，工具则使用备用值。
limit: int = 10在字段中设置默认值
您可以将默认值与约束结合起来，将默认值传递给字段，把规则和备用值放在同一个位置。
limit: int = Field(default=10, ge=1, le=100)使用枚举固定选项
当只有少数几个值合理时，枚举会将字段限制为确切的值集合，因此模型无法自行编造选项。
from enum import Enum
class Sort(str, Enum):
asc = "asc"
desc = "desc"将枚举作为类型使用
使用枚举类型声明字段后，Pydantic 只接受其中的成员，并自动拒绝其他值。
order: Sort = Sort.asc使用字面量表示少量集合
对于简单的固定集合，您也可以使用字面量，直接列出允许的值，而不必单独创建枚举类。
from typing import Literal
unit: Literal["c", "f"] = "c"约束会传递给模型
这些规则会成为 JSON模式的一部分，因此模型可以看到允许的范围和选项，并倾向于遵守它们。
快速检查
您希望某个字段只接受 asc 或 desc。哪种方式最合适？
回顾
使用字段设置范围和长度，使用普通默认值表示可选值，使用枚举或字面量表示模型必须遵守的固定选项。✅
用 AI 导师学习 Python — 免费
在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。
- 课程
- 30
- 课程
- 120
常见问题解答
「约束、默认值与枚举」课时是免费的吗？
是的 — 「约束、默认值与枚举」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 MCP Academy 课程的其余内容，请升级到 CoddyKit PRO。 MCP Academy 课程共包含 4 节课。
「约束、默认值与枚举」这节课中我会学到什么？
安全地限制取值范围并提供固定选项。 你通过在浏览器中直接运行的动手代码来练习 MCP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 MCP Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 MCP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「约束、默认值与枚举」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 MCP Academy 课中编写并运行代码吗？
能。每节 MCP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。