如何使用Pydantic实现操作系统文件与文件夹的递归数据模型
问题根因
Python解析Folder类定义时,List[Folder]中引用的Folder类尚未完成定义,属于类型前向引用场景,直接使用会抛出未定义错误。
解决方法
方法1:字符串形式前向引用(全版本兼容)
用字符串包裹未完成定义的类名即可,同时建议给子文件夹、文件列表设置默认空值,避免实例化时每次手动传空列表:
from typing import List from pydantic import BaseModel class File(BaseModel): name: str class Folder(BaseModel): folders: List["Folder"] = [] files: List[File] = [] name: str
方法2:使用Self类型(Python3.11+ 或安装typing_extensions)
写法更直观,Pydantic V1/V2均支持:
from typing import List # Python3.11及以上版本可直接从typing导入Self from typing_extensions import Self from pydantic import BaseModel class File(BaseModel): name: str class Folder(BaseModel): folders: List[Self] = [] files: List[File] = [] name: str
功能测试
可以直接按业务场景实例化嵌套结构,验证功能正常:
# 嵌套结构实例化 root_folder = Folder( name="根目录", files=[File(name="README.md")], folders=[ Folder( name="工作文档", files=[File(name="项目需求.docx")], folders=[ Folder(name="历史版本", files=[File(name="需求V1.docx")]) ] ) ] ) # 输出结构化数据 # Pydantic V1 请使用 root_folder.dict() print(root_folder.model_dump())
内容的提问来源于stack exchange,提问作者Pdeuxa
相关产品推荐
相关产品推荐

