PyYAML安装失败主因是Python环境错配，应使用对应解释器的pip安装；安全解析必须用yaml.safe_load()并显式指定UTF-8编码；键值含中文或易混淆词（如yes/null）须加双引号；深层嵌套访问推荐safe_get函数或get链式调用。
PyYAML安装失败或导入报错ModuleNotFoundError
常见原因是系统中存在多个Python环境，或用pip安装时没匹配当前运行的Python解释器。比如在VS Code里开了虚拟环境，却在系统终端里执行了pip install pyyaml，结果包装到了全局环境。
确认方式：在Python交互环境中运行import sys; print(sys.executable)，再用对应路径的pip安装：
python -m pip install pyyaml
如果仍报PermissionError，加--user参数；若用conda，优先用conda install pyyaml，避免混用pip和conda导致依赖冲突。
用yaml.safe_load()读取文件，别用yaml.load()
yaml.load()默认使用FullLoader，会执行任意Python对象构造（如!!python/object:os.system），配置文件若来自不可信来源，可能触发远程代码执行。生产环境必须用safe_load()。
立即学习“Python免费学习笔记（深入）”；
典型写法：
import yaml
<p>with open("config.yaml", "r", encoding="utf-8") as f:
data = yaml.safe_load(f)</p><h1>data 是 dict/list等原生类型，不是自定义对象- 文件编码必须显式指定为
utf-8，Windows记事本保存的BOM头YAML会导致UnicodeDecodeError - 若文件为空，
safe_load()返回None，记得判空再访问data["key"] - 不支持
.yml和.yaml自动识别——扩展名不影响解析，但文件内容必须符合YAML语法
YAML解析后字典嵌套层级深，访问时容易KeyError
YAML常用于多层配置（如数据库+缓存+日志），直接链式访问config["db"]["host"]["primary"]风险高。不要靠层层if key in dict判断。
推荐两种稳妥方式：
- 用
dict.get()链式调用：config.get("db", {}).get("host", {}).get("primary", "127.0.0.1") - 用
pydantic或marshmallow做结构校验（适合复杂配置），但小项目够用的话，就写个简单工具函数：
def safe_get(d, *keys, default=None):
for k in keys:
if isinstance(d, dict) and k in d:
d = d[k]
else:
return default
return d
<p>host = safe_get(config, "db", "host", "primary", default="localhost")中文键名或值乱码、解析成None或布尔值
YAML对未加引号的某些词有特殊含义，比如yes、no、on、off、null会被转成布尔或None，哪怕你本意是字符串。
示例错误写法：
status: yes # → 解析为 True，不是字符串"yes" name: 张三 # 若文件非UTF-8保存，可能变乱码或报错
正确做法：
- 所有含中文、特殊字符、易混淆关键字的值，**必须加双引号**：
status: "yes"、name: "张三" - 键名也建议加引号：
"数据库地址": "127.0.0.1"，避免解析器把带连字符的键（如api-url）误判为表达式 - 用编辑器（如VS Code）装YAML插件，实时语法检查能提前发现
true/True这类大小写陷阱
YAML看着简单，但缩进空格数、引号缺失、编码隐式转换这几个点，实际调试时比JSON花的时间多得多。
