You need to enable JavaScript to run this app. 如何使用Pydantic实现操作系统文件与文件夹的递归数据模型
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 22:24:05