Python读取含LaTeX未转义反斜杠的YAML文件并转义反斜杠

问题场景 #

你的YAML文件包含大量未转义的LaTeX反斜杠\，示例如下：

content: 
    - "explanation"   : "\text{Explanation 1} "
      "formula"       : "\exp({{a}}^2)  =  {{d}}^2  -  {{b}}^2"
    - "explanation"   : "\text{Explanation 2}"
      "formula"       : "{{b}}^2         = {{d}}^2      -  \exp({{a}}^2) "

需要在Python中读取后得到保留{{}}、且反斜杠被转义为\\的字典，供后续LaTeX解析器使用：

config = {
    "content": [
        {"explanation": "\\text{Explanation 1} ",
         "formula": "\\exp({{a}}^2)  =  {{d}}^2  -  {{b}}^2"},
        {"explanation": "\\text{Explanation 2}",
         "formula": "{{b}}^2         = {{d}}^2      -  \\exp({{a}}^2) "}
    ]
}

直接使用yaml.safe_load或unicode_escape编码读取会导致反斜杠被错误解析（比如\exp变成\x1bxp），无法满足需求。

解决方案 #

核心思路是先规避YAML对反斜杠的转义解析，手动将单反斜杠替换为双反斜杠后再加载：

代码实现 #

import yaml

# 1. 以纯文本模式读取YAML文件，避免Python自动转义
with open('your_config.yaml', 'r', encoding='utf-8') as f:
    raw_yaml = f.read()

# 2. 将所有单反斜杠替换为双反斜杠，YAML会将其解析为字面量反斜杠
processed_yaml = raw_yaml.replace('\\', '\\\\')

# 3. 加载处理后的内容
config = yaml.safe_load(processed_yaml)

原理说明 #

• YAML语法中，字面量反斜杠需要用\\表示，直接写\会被当成转义符解析（比如\e对应ESC控制字符）。
• 先读取原始文本并替换反斜杠，再交给PyYAML加载，既能保留{{}}的原始格式，又能让反斜杠被正确转义为Python字符串中的\\，符合LaTeX解析的要求。

可选方案（若可修改YAML文件） #

如果有权修改YAML源文件，可直接用单引号包裹LaTeX字符串，YAML会禁用转义解析，无需后续处理：

content: 
    - "explanation"   : '\text{Explanation 1} '
      "formula"       : '\exp({{a}}^2)  =  {{d}}^2  -  {{b}}^2'
    - "explanation"   : '\text{Explanation 2}'
      "formula"       : '{{b}}^2         = {{d}}^2      -  \exp({{a}}^2) '

内容的提问来源于stack exchange，提问作者Uwe.Schneider