Files

T

张宗平 13b3ebbe14 课程代码仓库初始化：Part1 (144) + Part3 (29) 全量生成与验证

把川大 wiki「02.Qt方向」课程代码整理为 CMake 管理的可编译运行项目。

Part1 C/C++ 强化 (p01/, 144 目标, host gcc/g++ 构建, 全绿):
- 修复全部编译失败：补 <cstring>/<fstream>/<iomanip>/<vector> 等缺失头
  (common_fix + infer_stl_includes 自动检测注入)、修正 pause() 壳注入
  (改检测已转换后的 pause 调用)、namespace 提升出函数体、const 成员函数
  正确性、dedupe 不再破坏函数重载集、K&R 隐式 int / 动态异常规范等
  C++17 移除特性的可编译等价改写。
- 目录采用深缩写 p01/ch04/s03/ (原 part1_cpp/ch04_class_object/03_ctor_dtor)。

Part3 Qt 桌面 (p03/, 29 目标, 隔离 Qt 5.14.2 构建, 全绿):
- gen_part3.py: Qt 外壳模板 (main+QApplication+show, QTimer 自动退出便于
  offscreen 验证)、AUTOMOC + .moc include、rewrite_* 处理散文混入/重载/
  资源依赖、生成占位 png/gif + .qrc + rundata 样例数据。
- 修正 QLable 笔误、全角分号、.→->、Windows 路径、QApplication 阻塞事件
  循环改为 QCoreApplication 等。

任务1 概念/版本验证:
- tools/std_probe.py: 跨 -std= 编译探针 (--pedantic-errors 让已废除特性硬失败)。
- tools/demo_versions/: K&R 隐式 int、三目左值、void* 转换、enum 赋整、
  const 经指针、动态异常规范 共 6 个跨版本演示。
- docs/VERSION_NOTES.md: 每条「原文说法→C17/C++17 是否成立→何版本成立→已验证」。

文档: 顶层 README、docs/SOURCE_PAGES.md (页面→目录映射)、
docs/ERRATA.md (Part1 修正)、docs/ERRATA_part3.md (Part3 修正)。
另修复 tools/run.sh / run_qt.sh 的 ${1:?...} 引号语法 bug。

隔离 Qt 验证: ldd 0 系统 Qt 引用; 173/173 目标全绿; p03 offscreen 运行通过。

2026-06-30 14:16:55 +08:00

5.1 KiB

Raw Blame History

川大 C++/LinuxC 课程「02. Qt 方向」代码仓库

本仓库把川大 wiki「02. Qt 方向」的课程代码整理成 CMake 管理的可编译运行的项目：每个示例 = 一个独立 add_executable 目标，可单独构建运行。所有源码由生成器（tools/gen_*.py）从抓取的 wiki 代码块产出，对 wiki 原始代码的每一处修正都记录在 docs/ERRATA*.md（透明可审计）。

标准基线：C17 / C++17（严格、不允许编译器扩展）。版本相关的概念另由 tools/std_probe.py + tools/demo_versions/ 跨版本演示（见 docs/VERSION_NOTES.md）。

仓库结构

qt-course/
├── CMakeLists.txt          顶层：C17/C++17 严格；option(BUILD_QT_PART)；隔离 Qt 版本断言
├── p01/                    Part 1：C/C++ 强化（控制台，host gcc/g++ 构建）144 个目标
│   ├── ch02 … ch09/        深缩写目录：p01/ch04/s03/ 这种形式
├── p03/                    Part 3：Qt 桌面（需隔离 Qt 5.14.2）29 个目标
│   ├── ch02 … ch11/        含 .qrc 资源、assets 占位图、rundata 样例数据
├── tools/
│   ├── gen_sources.py      共享引擎：标题解析 page_outline()、语言判定、common_fix()
│   ├── gen_part1.py        Part1 生成器（exact_fix / dedupe / emit_console）
│   ├── gen_part3.py        Part3 生成器（Qt 外壳 / rewrite / AUTOMOC / .qrc）
│   ├── file_name_map.py    (pageId, section) → 英文文件名词根（全覆盖）
│   ├── std_probe.py        跨 -std= 编译探针（任务 1 机制）
│   ├── demo_versions/      版本相关论断的最小演示片段
│   ├── run.sh / run_qt.sh  宿主机运行 p01 / p03 目标（Qt 走 LD_LIBRARY_PATH 隔离）
│   ├── install_qt_host.sh  宿主机直装隔离 Qt 5.14.2 到 .qt514/
│   ├── docker/             构建容器模型（Dockerfile + 脚本）
│   └── wiki_data/          抓取的 wiki 正文+代码块（生成器输入，只读）
├── docs/
│   ├── ERRATA.md           Part1 代码修正记录（自动生成）
│   ├── ERRATA_part3.md     Part3 Qt 代码修正记录（自动生成）
│   ├── VERSION_NOTES.md    版本相关概念验证记录
│   └── SOURCE_PAGES.md     wiki 页面 → 目录映射表
└── .qt514/                 隔离的 Qt 5.14.2 工具链（aqtinstall 装在仓库内，gitignore）

快速开始

Part 1（C/C++ 强化，无需 Qt）

cmake -S . -B build -G Ninja -DBUILD_QT_PART=OFF -DCMAKE_BUILD_TYPE=Debug
cmake --build build                      # 144 个目标全绿
tools/run.sh <target>                    # 例：tools/run.sh p1c04_03_01
cmake --build build --target all_p01_ch04_s03   # 只构建某章

Part 3（Qt 桌面，需隔离 Qt 5.14.2）

# 一次性：装隔离 Qt 5.14.2（装到 .qt514/，不碰系统 Qt 5.15）
tools/install_qt_host.sh
# 或用容器：tools/docker/docker_build_image.sh && tools/docker/docker_install_qt.sh

cmake -S . -B build -G Ninja -DBUILD_QT_PART=ON \
      -DCMAKE_PREFIX_PATH=$PWD/.qt514/5.14.2/gcc_64 -DCMAKE_BUILD_TYPE=Debug
cmake --build build                      # 144 + 29 = 173 个目标全绿

# 运行（隔离 Qt，靠 LD_LIBRARY_PATH）：
tools/run_qt.sh <target>                 # 例：tools/run_qt.sh qpainter_basic
# 离屏/自动化验证（无 X 也可）：
QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>

隔离验证：ldd build/p03/.../<target> 显示所有 Qt 库只解析到 .qt514/，零系统 Qt 引用。顶层 CMakeLists.txt 有版本断言——误连系统 Qt 5.15 会 FATAL_ERROR。每个 Qt GUI 目标注入 QTimer::singleShot 让程序 200ms 后自动退出，便于离屏验证。

目录命名（深缩写）

按「part / 章 / 节」三级缩写：

含义	形式	例
part（不编号）	`pNN`	`p01`=Part1，`p03`=Part3
章	`chNN`	`ch04`=第 4 章类和对象
节	`sNN`	`s03`=第 3 节对象的构造和析构

完整映射见 docs/SOURCE_PAGES.md。源文件名为英文蛇形（见 tools/file_name_map.py）。

重新生成全部源码（幂等）

改了生成器后，先清空再重生成：

rm -rf p01 p03 build && python3 tools/gen_part1.py && python3 tools/gen_part3.py

版本概念演示（任务 1）

# 把一段代码在多个 -std= 下编译，看「某概念在哪个版本成立」
tools/std_probe.py --lang c --file tools/demo_versions/kr_implicit_int.c \
    --standards c89,c99,c11,c17 --pedantic-errors

# 结论汇总见 docs/VERSION_NOTES.md（含 K&R 隐式 int、三目左值、void* 转换、
# enum 赋整、动态异常规范 等跨版本对照）

关键约束（红线）

不修改 tools/wiki_data/ 中的原始抓取数据（生成器只读输入）。
每处对 wiki 代码的修正都 record_erratum() 进 docs/ERRATA*.md（透明可审计）。
隔离 Qt：构建/运行一律走 .qt514/，不碰系统 Qt 5.15。
每个示例相对隔离：一文件一目标；不跨块合并造符号冲突。

详细续接说明见 HANDOFF.md。

5.1 KiB Raw Blame History Unescape Escape