求助：PyYAML 5.3.1在Python3.7中列表顺序无法保留的问题

问题核心原因 #

正常情况下，PyYAML 5.3.1对YAML序列（列表）的加载是保留原始顺序的，你遇到的顺序异常（尤其是Flask环境下变成字母序），大概率是以下两种情况：

1. 第三方依赖全局修改PyYAML行为：Flask环境中导入的某个扩展库，可能通过patch的方式修改了PyYAML的Loader类，替换了序列构造逻辑，强制对列表元素进行排序。
2. 公司定制化PyYAML版本：安全团队修改后的PyYAML，可能添加了条件触发的排序逻辑（比如仅在特定运行环境下生效），导致列表顺序被改变。

排查定位步骤 #

如果需要明确具体诱因，可以做以下验证：

• 对比命令行与Flask环境的依赖差异：分别执行pip freeze导出两个环境的包列表，逐一排查差异包是否有修改PyYAML的行为。
• 检查Loader的构造逻辑：在Flask启动前，打印PyYAML序列构造函数的实现，确认是否被篡改：

  import yaml
  print(yaml.FullLoader.construct_sequence)
  

  正常输出应指向PyYAML原生的构造方法，若显示为其他自定义函数，则说明逻辑被修改。
• 重置Loader构造逻辑测试：在Flask环境中手动恢复原生Loader的序列构造行为，再尝试加载YAML：

  import yaml
  from yaml.loader import FullLoader
  # 重置为原生实现
  yaml.FullLoader.construct_sequence = FullLoader.construct_sequence
  

  若此时列表顺序恢复正常，即可确认是Loader被第三方修改导致的问题。

解决办法 #

方案1：使用ruamel.yaml（推荐） #

ruamel.yaml是PyYAML的增强分支，原生支持序列顺序保留，且行为更稳定，不受第三方patch影响。若公司管控严格，可以直接引入其源码包离线安装：

from ruamel.yaml import YAML

# 初始化安全加载器（对应PyYAML的SafeLoader）
yaml = YAML(typ='safe')
with open('example.yaml', 'r') as f:
    datadict = yaml.load(f)
    data = datadict['data']
    print(f'{data}')

方案2：自定义Loader规避修改 #

自定义一个独立的Loader，强制使用原生序列构造逻辑，绕过全局修改：

import yaml
from yaml.loader import FullLoader

class OrderedSequenceLoader(FullLoader):
    def construct_sequence(self, node, deep=False):
        # 直接调用父类原生实现，确保保留原始顺序
        return super().construct_sequence(node, deep)

with open('example.yaml', 'r') as f:
    input_data = f.read()
    datadict = yaml.load(input_data, Loader=OrderedSequenceLoader)
    data = datadict['data']
    print(f'{data}')

方案3：切换至JSON格式 #

如果YAML的问题无法快速定位解决，切换到JSON是最稳妥的替代方案——JSON原生保证数组顺序，Python标准库json模块行为稳定，不会出现顺序混乱：
配置文件example.json内容：

{
    "data": ["start", "next"]
}

对应的Python代码：

import json

with open('example.json', 'r') as f:
    datadict = json.load(f)
    data = datadict['data']
    print(f'{data}')

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