yaml模块报错求助：ModuleNotFoundError与AttributeError问题排查

核心原因 #

• Python环境不匹配：运行脚本的Python解释器和ipython使用的不是同一个环境，你之前安装的YAML模块只存在于ipython对应的环境中，脚本环境未安装该模块，导致ModuleNotFoundError。
• 错误的安装包：pip3 install yaml安装的并非官方Python YAML库（官方库为pyyaml），这个非官方的yaml包功能不全或存在兼容问题；而brew安装的是底层C库libyaml，并非Python模块，无法解决Python代码的依赖问题，甚至引发环境冲突。
• 新版API变更：若安装的是pyyaml 6.0及以上版本，yaml.load因安全风险被默认禁用，直接调用会出现AttributeError。

解决步骤 #

1. 确认脚本使用的Python环境 #

在脚本开头添加以下代码，运行后查看输出的Python路径：

import sys
print(sys.executable)

同时在ipython中执行同样代码，对比两个路径，确认是否为同一环境。

2. 给脚本环境安装官方pyyaml #

用第一步得到的脚本Python路径，执行安装命令（替换为你的实际路径）：

/path/to/your/python -m pip install pyyaml

例如，若脚本路径为/usr/local/bin/python3，则执行：

/usr/local/bin/python3 -m pip install pyyaml

3. 适配新版pyyaml的API #

如果安装的是pyyaml 6.0+版本，修改代码中的加载逻辑：

• 信任YAML内容安全性时，指定Loader调用：

  import yaml
  with open("your_file.yaml") as f:
      data = yaml.load(f, Loader=yaml.Loader)
  

• 不信任内容时，使用安全加载（推荐）：

  import yaml
  with open("your_file.yaml") as f:
      data = yaml.safe_load(f)
  

4. 清理冲突包（可选） #

若之前安装过非官方的yaml包，用对应环境的pip卸载：

/path/to/your/python -m pip uninstall yaml

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