Python Dataclass无法识别YAML配置中的Path对象，如何解决？

你的问题核心在于：YAML的safe_load默认会把配置里的Path("/root/path")解析成普通字符串，而不是实例化的Path对象，导致Dataclass虽然声明了Path类型，但实际接收的是字符串。以下是两种可行的解决方法：

方法一：修改YAML为纯路径字符串，在Dataclass中自动转换 #

这种方法最直观，不需要修改YAML解析逻辑，只需在Dataclass初始化后做类型转换：

修改后的YAML配置 #

# config.yml
---
ROOT_PATH: "/root/path"

对应的Python代码 #

from dataclasses import dataclass
from pathlib import Path
import yaml

@dataclass
class Config:
    ROOT_PATH: str | Path

    def __post_init__(self):
        # 在初始化完成后，强制将字段转换为Path对象
        self.ROOT_PATH = Path(self.ROOT_PATH)

if __name__ == "__main__":
    with open("./config.yml") as file:
        yml = yaml.safe_load(file.read())
        config = Config(**yml)
        print(f"Field type: {type(config.ROOT_PATH)}")
        # 输出示例：Field type: <class 'pathlib.PosixPath'>

方法二：给PyYAML注册自定义构造器，直接解析Path标签 #

如果你想保留YAML中类似Path("/root/path")的写法，可以通过PyYAML的自定义标签来实现自动解析：

修改后的YAML配置（使用自定义标签） #

# config.yml
---
ROOT_PATH: !path "/root/path"

对应的Python代码 #

from dataclasses import dataclass
from pathlib import Path
import yaml

# 定义自定义构造器，处理!path标签
def path_constructor(loader, node):
    # 获取标签对应的字符串值并转换为Path对象
    path_str = loader.construct_scalar(node)
    return Path(path_str)

# 注册构造器到PyYAML
yaml.add_constructor('!path', path_constructor)

@dataclass
class Config:
    ROOT_PATH: Path

if __name__ == "__main__":
    with open("./config.yml") as file:
        yml = yaml.safe_load(file.read())
        config = Config(**yml)
        print(f"Field type: {type(config.ROOT_PATH)}")
        # 输出示例：Field type: <class 'pathlib.PosixPath'>

补充说明 #

标准库的dataclass本身不会自动根据类型注解做类型转换，所以必须手动处理字符串到Path的转换。如果你的项目允许使用第三方库，pydantic（或pydantic v2）会更省心——它会自动根据类型注解完成字符串到Path的转换，无需手动写__post_init__或自定义YAML构造器。

内容的提问来源于stack exchange，提问作者user2514157