Python confuse 的 YAML 配置库
confuse默认不读项目根目录的yaml文件，需显式调用set_file("config.yaml")；仅识别.yaml后缀；get()返回none可能因schema未声明字段或类型校验失败；环境变量需主动add_env_source()才生效；命令行参数需手动转为dict或yaml注入。
Python 里 confuse 库读不到 YAML 配置文件？先查路径和扩展名
默认情况下，confuse 不会自动加载当前目录下的 config.yaml 或 config.yml —— 它只认 config.yaml，且只在预设的几个路径里找（比如 $XDG_CONFIG_HOME、/etc/），不会扫你项目根目录。
- 显式指定路径最稳：
Config().set_file("config.yaml")，路径支持相对和绝对 - 确保文件后缀是
.yaml，.yml不被识别（PyYAML 底层限制，confuse没做兼容） - 如果用
set_file()加载失败，会静默忽略，不报错；加个try/except包住并打印os.path.abspath("config.yaml")看路径对不对
confuse 的 get() 返回 None 而不是默认值？检查 schema 定义顺序
confuse 的行为依赖 schema 声明顺序：它先合并所有配置源（文件、环境变量、代码设置），再按 schema 中字段定义的顺序校验和转换。如果某个 key 在 YAML 里存在但类型不对，或者 schema 里没声明，get() 就可能返回 None，而不是你期望的默认值。
- schema 必须显式声明字段，哪怕只写
String(default="x")；没声明的 key 不会进入最终配置对象 - 默认值只在“该 key 完全未出现”时生效；若 YAML 里写了
port: ""或debug: null，而 schema 要求Integer()，就会校验失败 →get()返回None - 调试时用
config.dump()打印合并后的原始结构，确认 key 是否真的存在、类型是否匹配
环境变量覆盖 YAML 失效？注意前缀和大小写规则
confuse 默认用大写 + 下划线映射嵌套 key，比如 database.host 对应环境变量 DATABASE_HOST，但这个行为受 Config().add_env_source(prefix="MYAPP_") 控制 —— 如果没调用 add_env_source()，环境变量压根不生效。
LibLib AI
中国领先原创AI模型分享社区，拥有LibLib等于拥有了超多模型的模型库、免费的在线生图工具，不考虑配置的模型训练工具
- 必须主动调用
add_env_source()，否则只读文件 - prefix 是可选的，但一旦设了（如
MYAPP_），那database_host就得写成MYAPP_DATABASE_HOST - YAML 里的
host:和环境变量HOST不会自动对应；必须是完整路径展开，database.host→DATABASE_HOST，中间点变下划线，全大写
用 confuse 做命令行参数注入？别硬塞，改用 add_yaml_source() 动态构造
confuse 本身不解析 sys.argv，也没有内置 CLI 支持。想让 --port 8000 覆盖配置，不能靠 magic，得手动把参数转成 dict 再喂进去。
- 推荐做法：用
argparse解析后，调用config.set_args(args)（需提前定义 schema 支持这些字段） - 更灵活的方式是构造临时 YAML 字符串：
config.add_yaml_source(yaml.dump({"port": args.port})) - 注意：命令行优先级高于文件，但低于
set_args()或set_dict()；顺序错了就覆盖不了
最常被忽略的是 schema 声明和实际加载顺序的耦合——set_file()、add_env_source()、set_args() 的调用次序直接决定最终值，不是“谁写得晚谁赢”，而是按添加顺序从低到高叠加。调错一行，配置就悄悄变了。