YAML配置必须严格遵循logging模块schema：顶层含version: 1、formatters、handlers、loggers；需用yaml.safe_load()加载并传给dictConfig()；logger名须与getLogger()完全一致；禁止写Python代码。
YAML配置文件的结构必须符合logging模块的schema
Python的logging.config.dictConfig()不直接支持YAML，但可以先用yaml.safe_load()读取YAML内容，再传给dictConfig()。关键在于YAML结构必须严格匹配logging配置字典的规范：顶层必须包含version（值为1），可选disable_existing_loggers，以及formatters、handlers、loggers三个核心键。
常见错误是漏掉version: 1，导致抛出ValueError: dictionary doesn't specify a version；或者把handlers写成handler（少s），引发KeyError。
示例最小可用YAML片段：
version: 1
formatters:
simple:
format: '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
handlers:
console:
class: logging.StreamHandler
formatter: simple
level: INFO
loggers:
myapp:
level: DEBUG
handlers: [console]
propagate: false加载YAML时要处理PyYAML依赖和编码问题
logging.config本身不带YAML解析能力，必须手动安装pyyaml并显式调用yaml.safe_load()。没装包会报ModuleNotFoundError: No module named 'yaml'；用yaml.load()（不带safe）则存在反序列化风险，不推荐。
立即学习“Python免费学习笔记（深入）”；
文件路径和编码也容易出错：Windows下路径含中文或空格时，建议用pathlib.Path构造路径；YAML文件若含中文，必须以UTF-8打开，否则safe_load()可能解码失败。
实操建议：
- 运行前执行
pip install pyyaml - 用
with open(config_path, encoding='utf-8') as f:打开文件 - 始终用
yaml.safe_load(f)，别用load - 加一层
try/except yaml.YAMLError捕获格式错误
logger名与代码中getLogger()必须完全一致
YAML里定义的loggers下每个子项的key，就是logging.getLogger('xxx')中的字符串。大小写、点号、下划线都必须逐字符匹配。比如YAML写了myapp.api，但代码调用getLogger('myapp.api.v1')，则该日志不会被这个logger接管——它会向上回溯到myapp.api（如果propagate为True），或最终落到root logger。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
另一个典型陷阱：YAML中logger未显式声明level，又没设propagate: true，会导致日志静默丢失。因为默认level是WARNING，低于它的INFO/DEBUG不会输出，且不传播。
调试技巧：
- 在加载配置后，打印
logging.Logger.manager.loggerDict.keys()确认logger是否注册成功 - 临时将目标logger的
level设为DEBUG，排除级别过滤问题 - 检查
handlers是否真被分配给了该logger（看YAML中handlers列表内容）
不能在YAML里直接写Python对象或lambda
YAML是数据序列化格式，不支持代码执行。像class: mymodule.MyHandler这种写法，要求对应类必须已导入且可被字符串路径解析；而formatter字段只能引用已定义的formatter名（如simple），不能写format: !python/object/apply:str之类。
更隐蔽的问题是：某些第三方Handler（如watchtower.CloudWatchLogHandler）需要额外参数（如log_group、stream_name），这些必须在YAML的handlers中以字典形式展开，不能省略或错位。
例如正确写法：
handlers:
cloudwatch:
class: watchtower.CloudWatchLogHandler
log_group: 'myapp-prod'
stream_name: 'web-server'
formatter: simple如果漏掉log_group，初始化时会抛TypeError: __init__() missing 1 required positional argument。
复杂逻辑（如动态生成handler实例、条件化formatter）不适合放进YAML，应退回到Python字典配置或代码中构建。
