如何使用PyYAML导出无标签的Python对象？

这个问题我之前也碰到过，PyYAML默认会给自定义类的序列化结果加上类型标签（比如!!python/object:__main__.YourClass），目的是为了反序列化时能还原成原类实例。但如果只需要输出普通的无标签YAML结构，可以试试下面两种实用思路：

方法1：手动将对象转换为字典 #

最简单直接的方式就是把自定义对象的属性提取成普通字典，再传给yaml.dump。你可以用Python内置的vars()函数快速获取实例的属性字典，或者给类写一个to_dict()方法来更精细地控制输出内容（比如过滤敏感字段）。

示例代码：

import yaml

class User:
    def __init__(self, username, email, age):
        self.username = username
        self.email = email
        self.age = age

# 创建实例
user = User("johndoe", "john@example.com", 32)

# 方式A：用vars()快速转字典
print(yaml.dump(vars(user), sort_keys=False))

# 方式B：自定义to_dict方法（更灵活，可按需筛选字段）
class User:
    def __init__(self, username, email, age):
        self.username = username
        self.email = email
        self.age = age
    
    def to_dict(self):
        # 只输出公开字段，隐藏邮箱信息
        return {
            "username": self.username,
            "age": self.age
        }

print(yaml.dump(user.to_dict(), sort_keys=False))

输出的YAML会是纯键值对结构，完全没有类型标签。

方法2：注册自定义Representer #

如果不想每次都手动转字典，可以给PyYAML注册一个representer函数，告诉它如何序列化你的自定义类。这样每次dump该类的对象时，PyYAML都会自动按照你定义的规则处理，无需手动转换。

示例代码：

import yaml

class Product:
    def __init__(self, name, price, stock):
        self.name = name
        self.price = price
        self.stock = stock

# 定义representer函数：把Product对象映射成普通YAML字典
def product_representer(dumper, obj):
    # 使用vars(obj)获取属性字典，也可以自定义字段映射逻辑
    return dumper.represent_mapping('tag:yaml.org,2002:map', vars(obj))

# 给PyYAML注册这个representer
yaml.add_representer(Product, product_representer)

# 测试序列化
product = Product("Wireless Headphones", 99.99, 50)
print(yaml.dump(product, sort_keys=False))

这里的tag:yaml.org,2002:map是PyYAML内置的普通字典标签，用它替换默认的自定义类标签后，最终输出就是无类型标识的普通YAML结构。

小提示 #

• 如果你的类有嵌套的自定义对象，需要给每个嵌套类都注册对应的representer，或者在representer函数里手动把嵌套对象也转成字典。
• 如果你使用的是PyYAML的safe_dump方法，注册representer后依然可以正常使用（因为我们用的是内置的安全标签）。

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