【第37期】Python JSON 与配置详解：序列化、反序列化、嵌套结构和配置文件

CSDN 完整教程

系列：《从小白到 AI 大模型开发工程师的进阶之路》技术点：AI-0125 JSON 与配置主人公：小蓝伞

本文是第 37 期，围绕【序列化、反序列化、嵌套结构和配置文件】展开。示例用于复现实验；标注【建议验证】的部分需要按读者自己的 Windows、Python 版本和网络条件执行。

一、问题背景与适用场景

读取 config.json 的服务地址和超时字段，缺失字段使用默认值，错误类型拒绝启动。本期要把概念落成一个可观察、可回滚的小实践。

二、先给结论

JSON 只负责数据格式，加载后还要校验结构和类型；默认配置、环境变量与密钥配置应有明确覆盖顺序。本期最小产出：可配置脚本。

三、前置准备

Windows 10/11，建议 Python 3.11 或项目采用的兼容版本。
练习目录：D:\ai-learning\issue-37；涉及文件、依赖或配置时先备份。
不要提交 Token、密码和个人路径；未执行命令不得写成实测结果。

四、最小可复现实践

在练习目录保存并执行：

复制代码

import json
from pathlib import Path

def load_config(name):
    try:
        with Path(name).open(encoding='utf-8') as file:
            value = json.load(file)
        if not isinstance(value, dict):
            raise ValueError('根节点必须是对象')
        timeout = value.get('timeout', 10)
        if not isinstance(timeout, (int, float)) or timeout <= 0:
            raise ValueError('timeout 必须为正数')
        return {'base_url': 'https://example.com', 'timeout': timeout, **value}
    except (OSError, json.JSONDecodeError, ValueError) as exc:
        print(f'配置不可用：{exc}')
        return None

print(load_config('config.json'))

预期结果：有效配置合并默认值；文件不存在、格式错误或超时非法时说明原因。

五、关键原理与工程判断

1. 先定义输入和成功判据

JSON 只负责数据格式，加载后还要校验结构和类型；默认配置、环境变量与密钥配置应有明确覆盖顺序。

2. 保留状态和失败原因

把输入、输出、版本、目录和完整错误记入 README 或日志，便于定位而不是只写【失败】。

3. 小步执行与回滚

先跑最小样例，再一次改一个变量；危险操作先 dry-run、备份或 Git 提交。

六、常见问题与避坑

用 eval 执行配置内容；JSON 只用 json.load 或 json.loads 解析。
只检查 JSON 语法，不检查字段类型和范围；加载后执行结构校验。
把密码、Token 写入配置并提交 Git；用环境变量或密钥管理服务承载秘密。

七、验证清单

正常、边界、失败三类输入均有验证。
重新打开终端或进程后复验，排除缓存和当前会话影响。
产物能再次读取、运行或恢复；未实测部分标记【建议验证】。

八、面试题

本期技术点解决什么问题？解决输入、状态或失败边界的可控性。
为什么先做最小实践？降低变量数量，区分语法、环境和业务问题。
出现错误先做什么？保存完整错误，确认版本、目录、权限和输入。
如何判断真正生效？重启相关进程后，用独立命令和功能测试复核。
什么时候不能照搬示例？系统、版本、权限或输入契约不同，就要先调整并阅读官方文档。

九、本期小结与下一期

本期完成可配置脚本，把正确路径和失败路径都变成可验证动作。下一期继续学习资料库中的下一个技术点。点个关注不迷路，跟着小蓝伞把 Python 基础变成工程能力。可靠的程序也要能解释失败。

官方资料

json --- JSON encoder and decoder --- Python 3.14.7 documentation