张宗平
83620c0cf5
- docs/teaching/OUTLINE.md、slides/day1-5.html、index.html：替换此前自定义的 4 天方案，严格对齐 docs/TRAINING_PLAN_2026.md「C++方向」Day1-5 课堂内容 （Day6-10 为纯项目实作，不在教案范围） - docs/teaching/examples/：官方方案书要求但仓库 p03/(wiki 抓取内容) 未覆盖的 QSS/Model-View/JSON/QThread/QPropertyAnimation/QStateMachine 六个技术点， 各补一个最小可运行示例 + README 教学文档，均已离屏验证跑通；手工维护， 不属于 gen_part3.py 生成产物 - 根 CMakeLists.txt：接入 docs/teaching/examples 构建（BUILD_QT_PART 分支内）， 不改动生成器管理的 p01/p03 CMakeLists - 任务卡改为目标/验收标准/基础知识参考三段式模板，custom.css 配套新增样式 - docs/teaching/PRETEST.md：10 题 10 分钟 C++ 摸底测验，验证教案假定的受众 基础是否成立，并与 OUTLINE.md §0 的分层预案挂钩
2.6 KiB
2.6 KiB
JSON 解析与写入 —— 教学补充示例
对应方案书「C++方向 Day3」："Qt 文件 IO 操作与 JSON 等主流数据格式解析"。 仓库
p03/ch11的 wiki 抓取内容覆盖了QFile/QTextStream/QDataStream， 唯独没有 JSON，本示例是手工补写的教学补充，不属于tools/gen_part3.py的生成产物。
概念
Qt 从 5.0 起自带 JSON 支持（QtCore 模块，不需要额外依赖第三方 JSON 库），
核心是四个类：
QJsonValue—— 一个 JSON 值（字符串/数字/布尔/数组/对象/null）；QJsonObject—— 键值对集合，对应 JSON 里的{ ... }；QJsonArray—— 值的列表，对应 JSON 里的[ ... ]；QJsonDocument—— 顶层容器，负责整个文档和字节流（QByteArray）之间的 相互转换（序列化/反序列化）。
与 p03/ch11 已有的 QTextStream/QDataStream 对比：那两个解决的是"文本行"
和"二进制结构体"的读写；JSON 解决的是"带层级结构的数据"（对象嵌数组嵌对象）的
读写，是目前最常见的配置文件/网络接口数据格式。
代码走读
- 用
QJsonObject/QJsonArray构造一份"学员信息"数据； QJsonDocument(obj).toJson(QJsonDocument::Indented)序列化成带缩进的可读 字节流（QJsonDocument::Compact则是不带空白的紧凑格式，写文件/网络传输 常用这个）；QJsonDocument::fromJson(bytes)反序列化回来，.isObject()判断顶层类型后 逐个字段取值。
这个示例不涉及 GUI，纯粹是数据结构的构造/序列化/反序列化，所以用
QCoreApplication 而不是 QApplication，不需要 QT_QPA_PLATFORM=offscreen。
验证方式
tools/run_qt.sh qt_json_parse_write
预期终端输出：先打印一段带缩进的 JSON 文本，再打印从中解析出的姓名/分数/标签。
练习方向（供任务卡引用）
- 把结果写入一个真实文件（结合
p03/ch11/qfile_basic.cpp的QFile写法）， 再从文件读回来解析，构成一个完整的"落盘 JSON 配置"流程； - 故意构造一段格式错误的 JSON 字符串喂给
fromJson，观察parsed.isNull()为true时如何做错误提示（而不是让程序崩溃或读到脏数据）。
参考
- 本仓库对照：
p03/ch11/qfile_basic.cpp、qtextstream_io.cpp - Qt 官方文档：JSON Support in Qt（doc.qt.io，选读·需联网）