必须安装pyyaml而非yaml，因为PyPI上不存在名为yaml的包；pip install yaml会报“Could not find a version that satisfies the requirement yaml”错误，正确命令是pip install pyyaml，且需确保pip与Python解释器路径一致。
别装 yaml，它不存在；必须装 pyyaml，否则一定报错。
为什么 pip install yaml 会失败
错误信息通常是 ERROR: Could not find a version that satisfies the requirement yaml。因为 PyPI 上根本没有叫 yaml 的包——官方库名是 pyyaml（全小写），大小写敏感，拼错或简写都会失败。
- 常见误操作：
pip install yaml、pip install YAML、pip install PyYaml（首字母大写或大小写混用） - conda 用户也得用
conda install pyyaml，不是conda install yaml - 如果已执行过错误命令，建议先清理缓存：
pip cache purge，再重试
正确安装命令与环境确认
无论 Windows、macOS 还是 Linux，统一用：
pip install pyyaml
但要注意这三件事：
- 确保当前终端处于目标 Python 环境中：虚拟环境要先
source venv/bin/activate（Linux/macOS）或venv\Scripts\activate（Windows），conda 环境要先conda activate myenv - 若提示权限错误（如 macOS/Linux 的
PermissionError），加--user参数：pip install --user pyyaml - 国内用户装得太慢？直接配镜像源更稳：
pip install pyyaml -i https://pypi.tuna.tsinghua.edu.cn/simple
验证是否真装上了
别只看终端输出的 Successfully installed，进 Python 解释器里 import 一下才作数：
python -c "import yaml; print(yaml.__version__)"
如果报 ModuleNotFoundError: No module named 'yaml'，说明没装对或装到别的 Python 里了。此时检查：
-
which python（macOS/Linux）或where python（Windows）和pip --version输出的 Python 路径是否一致 - 用
python -m pip install pyyaml替代pip install pyyaml，可强制对齐解释器 - 某些 IDE（如 PyCharm）自带独立包管理器，需在 Settings → Project → Python Interpreter 里手动添加
pyyaml
要不要换 ruamel.yaml
如果你要保留注释、处理多文档、写回时维持格式，pyyaml 做不到——它的 dump 会丢注释、重排缩进、把单引号变双引号。这时候该上 ruamel.yaml：
pip install ruamel.yaml
但它不是 pyyaml 的替代品，而是另一套 API。比如读取要写成：
from ruamel.yaml import YAML<br>yml = YAML()<br>with open("config.yml") as f:<br> data = yml.load(f)
简单读写配置，pyyaml 够用；一旦涉及“编辑后保存原格式”，就得切过去。
