Python如何在解析 YAML 文件时保留每个条目的原始行号信息

这样读取yaml文件后，报错信息显示的是item的编号，但是如果想要显示这个item在yaml文件中的原始行号：

with open(yaml_path, 'r', encoding='utf-8') as file:
    data = yaml.safe_load(file)

if not isinstance(data, list):
    raise ValueError("YAML 数据格式错误：应为条目列表")

errors = []
terms_seen = set()

for idx, entry in enumerate(data, start=2):# 从2开始，行号计算标题行
    context = f"Entry {idx} ('{entry.get('Term', 'Unknown')}')"

为了在解析 YAML 文件时保留每个条目的原始行号信息，可以使用 ruamel.yaml 替代 PyYAML（yaml.safe_load 就是它的一部分）。ruamel.yaml 支持保留注释和行号，是专门为这种需求设计的。

✅ 目标：

你希望在处理 entry 时能知道它在原始 YAML 文件中的行号，以便在报错时提示更直观。

🔧 解决方案：

使用 ruamel.yaml 加载并追踪每条数据的行号：

from ruamel.yaml import YAML
from ruamel.yaml.compat import StringIO

yaml = YAML()
yaml.preserve_quotes = True  # 可选：保持原始引号

with open(yaml_path, 'r', encoding='utf-8') as f:
    content = f.read()
    data = yaml.load(content)

# 确保数据是列表形式
if not isinstance(data, list):
    raise ValueError("YAML 数据格式错误：应为条目列表")

errors = []
terms_seen = set()

for entry in data:
    # 获取该 entry 的行号（+1，因为 ruamel 使用0-based）
    line_no = entry.lc.line + 1
    term = entry.get('Term', 'Unknown')
    context = f"Line {line_no} ('{term}')"

    # 示例：检测重复术语
    if term in terms_seen:
        errors.append(f"{context} - Term 重复")
    else:
        terms_seen.add(term)

# 打印错误
for err in errors:
    print(err)

📌 示例 YAML 内容

- Term: apple
  Definition: A fruit
- Term: banana
  Definition: Another fruit
- Term: apple
  Definition: Duplicate

输出：

Line 5 ('apple') - Term 重复

📦 安装 ruamel.yaml

如果你未安装 ruamel.yaml，可以通过 pip 安装：

pip install ruamel.yaml