Day 1
- 开训 + C++ 回顾/工具链
- C++/Qt 方向实训 · 第 1 / 5 天 · 对齐官方方案书 Day1
+ 开训 + C++ 回顾与提升（全天 C++）
+ C++/Qt 方向实训 · 第 1 / 4 个讲授日 · 对齐 2026-07 新版 10 天安排
- - 模块 A（3 课时）：团队建设 / 敏捷 Scrum / C++ 在企业中的应用（讨论型，无编码）
- - 模块 B（3 课时）：C++ 环境搭建 / 高级程序回顾 / CMake / Vcpkg（压缩讲解）
+ - 上午（08:30–11:00 讲 / 11:00–12:00 练）：开训 · C++ 技术版图 · 环境与 CMake · OOP 回顾
+ - 下午（13:30–16:00 讲 / 16:00–17:00 作业）：继承与多态 · 内存管理 · STL 常用容器
- 本教案假定学员已掌握 C++ 基础语法与 OOP 概念——方案书对今天下午的
- 官方定位是"回顾和提升"，不是零基础教学。今天开始的 5 天覆盖方案书 C++方向
- Day1–5 全部课堂内容，Day6–10 是纯项目实作。
+ 本教案假定学员已掌握 C++ 基础语法与 OOP 概念——今天定位是"回顾和提升"，
+ 不是零基础教学。Day1–4 讲授，Day5 综合案例，Day6–10 项目开发与答辩。
+ 大纲：docs/teaching/OUTLINE_4DAY.md
-
+
-
- 模块 B · 讲授 35min（巡礼式，压缩讲解）
- C++ 回顾 / CMake / Vcpkg 讲
- 只挑「学过但容易讲不透」的点，不逐章展开——方案书官方定位是
- "回顾和提升"，深度让位于 Day2–5 的 Qt 内容。
-
-
-
- namespace 作用域 讲
-
-
核心概念
-
- - "作用域"不是"文件顺序"——很多人误以为 namespace 只是给名字加前缀，实际上它定义的是
- 一段可以被跨文件延续、跨块合并的作用域，同一个命名空间可以在多个文件里反复打开、追加内容。
-
-
-
常见的坑
-
- - 在头文件里写
using namespace std;：会把整个命名空间污染带给所有
- include 这个头文件的地方，容易引发命名冲突，规范做法是只在 .cpp 里用，或干脆不用、
- 全程写限定名。
-
-
出处：p01/ch03/namespace_syntax.cpp，
- 对照 docs/ERRATA.md
-
-
-
- 函数重载决议 讲
-
-
核心概念
-
- - 编译器靠"名字改写"（name mangling）把重载函数变成不同的符号；二义性往往不是代码写
- 错了，而是重载集合里存在两个"一样好"的候选，编译器无法替你选。
-
-
-
常见的坑
-
- - 隐式类型转换会扩大重载候选集——比如
int/double 都能转
- float 参数，传一个 long 进去可能触发意料之外的重载版本。
-
-
出处：p01/ch03/function_overload_mechanism.cpp
-
-
-
- 引用的本质 讲
-
-
核心概念
-
- - 把引用理解成"自动解引用的 const 指针"——这个实现视角能解释引用为什么必须初始化、
- 为什么不能重新绑定到另一个对象。
-
-
-
常见的坑
-
- - 返回局部变量的引用：函数结束局部变量已销毁，返回的引用变成悬空引用，后续访问是
- 未定义行为——和返回局部变量指针是同一类坑。
-
-
出处：p01/ch03/reference_essence.cpp
-
-
-
- 虚析构与内存泄漏 讲
-
-Base* p = new Derived();
-delete p; // 如果 ~Base() 不是 virtual，~Derived() 不会被调用——经典泄漏
-
-
-
核心概念
-
- - 通过基类指针
delete 派生类对象时，只有基类析构函数是 virtual
- 才会走虚函数表找到派生类的析构函数——这是"多态"在析构这个场景下的具体体现。
-
-
-
常见的坑
-
- - 只要一个类可能被继承、且可能通过基类指针删除派生对象，就应该把析构函数声明为
-
virtual——即使当前基类本身没什么要清理的，这是个防御性约定。
-
-
出处：p01/ch04/s08/virtual_dtor_purpose.cpp
-
-
-
-
-
- C++11/14/17/20+：一门仍在进化的语言 讲
-
-
核心概念——每 3 年一次实打实的能力升级，不是小修小补
-
- - C++11（"现代 C++ 元年"）：
auto 类型推导、智能指针
- unique_ptr/shared_ptr（RAII 终结手动 new/delete）、
- 右值引用 && + 移动语义（消除不必要的拷贝）、lambda 表达式、
- 语言级并发 std::thread/mutex/atomic、
- nullptr、constexpr。
- - C++14：泛型 lambda（参数写
auto）、函数返回类型自动推导、
- std::make_unique 补齐。
- - C++17：结构化绑定
auto [a,b] = pair、if/switch
- 带初始化语句、std::optional/variant/string_view、
- 标准库终于有跨平台的 std::filesystem。
- - C++20（号称"自 C++11 以来最大的一次变革"）：concepts 概念（模板约束，报错从
- 几百行天书变成一句话）、ranges 范围库（
view | filter | transform 管道式组合）、
- coroutines 协程（co_await 把异步代码写成同步的样子）、modules 模块（挑战头文件
- 体系）、<=> 三路比较一行换 6 个运算符。
-
-
-
常见的坑
-
- - 新标准 ≠ 现在能用：生产环境的编译器/CI 常年落后最新标准 1–2 个版本，用新特性前先确认
- 目标工具链
-std= 支持到哪。本仓库出于教学稳定性选 C++17 作为基线（顶层
- CMakeLists.txt），可用 tools/std_probe.py 自己验证某特性最早从哪个
- 标准开始能编译（宿主 gcc 13.3 原生支持到 C++23）。
-
-
-
缺口说明
-
本节为纯概念巡礼，无对应仓库示例——具体新特性的动手练习超出本次"C++回顾"压缩讲解范畴，
- 感兴趣可用 tools/std_probe.py + tools/demo_versions/ 自行探索
- （参见 docs/VERSION_NOTES.md）。
-
核心概念
- CMake 是"生成构建系统的工具"而不是构建系统本身：
cmake -S -B 读
- CMakeLists.txt 生成 Ninja/Makefile 工程，cmake --build 才是
- 真正编译。option(BUILD_QT_PART) 控制是否编译 Qt 部分，每个示例一个
- add_executable 目标，这就是"一文件一目标"约定的由来。
+ CMakeLists.txt 生成 Ninja/Makefile 工程（Makefile 是它的生成目标之一——
+ 这就是两者的关系），cmake --build 才是真正编译。
+ option(BUILD_QT_PART) 控制是否编译 Qt 部分，每个示例一个
+ add_executable 目标。
常见的坑
- - 改了
CMakeLists.txt 却没重新 cmake 配置（只 build）：
- 大多数改动 CMake 会自动侦测重新配置，但换了生成器/清了缓存等情况需要重新走
- -S -B 一次。
+ - 改了
CMakeLists.txt 却没重新配置：大多数改动 CMake 会自动侦测，
+ 但换生成器/清缓存后需要重新走一次 -S -B。
- 出处：仓库根 CMakeLists.txt
+ 出处：仓库根 CMakeLists.txt
+ · 包管理器一分钟：vcpkg 用 toolchain 文件让 find_package 自动找到三方库；
+ 本仓库选"隔离 Qt 手动装"，两种思路都要认识。
- Vcpkg 包管理器（概念，无演示） 讲
+ ★ 编译错误 vs 链接错误：排查方向完全不同 讲
+ main.cpp:12:5: error: 'foo' was not declared ← 编译期：带文件行号
+main.o: undefined reference to `Widget::bar()' ← 链接期：没有行号
核心概念
- - C++ 生态的包管理器，解决"第三方库怎么装、怎么被 CMake 找到"的问题——一次
-
vcpkg install，配合 CMake 的 toolchain 文件，find_package
- 就能自动找到头文件和库。
+ error: 带行号 = 编译期问题（语法/类型/没声明）——回代码里查那一行；
+ undefined reference 无行号 = 链接期问题（有声明没定义/缺库/缺目标文件）——
+ 查"定义在哪、链没链进来"，回头检查语法是南辕北辙。
常见的坑
- - 不是所有第三方库都必须用包管理器装——本仓库用的是"隔离 Qt 手动装"
- （
tools/install_qt_host.sh）而非 vcpkg，两种思路都要认识：包管理器省心但
- 引入额外工具链，手动隔离装则精确控制版本/路径，各有取舍。
+ - 中初级学员见到
undefined reference 的第一反应是检查拼写和语法——方向就错了。
+ 明天 Qt 的"忘写 Q_OBJECT"报的正是链接错误，且报错完全不提宏，记住今天这页。
-
-
缺口说明
-
本仓库暂无 vcpkg 可运行示例——安装真实 vcpkg 工具链超出最小示例范畴，此处仅作概念介绍。
+
+
+
+ OOP 回顾：类 / 对象 / 封装 + namespace 讲
+
+
核心概念
+
+ - 封装 = 数据和操作绑定 + 访问控制（public/private 是给"人"划的边界，不是安全机制）；
+ 构造/析构对应对象生命周期的两端——这个心智模型下午的"所有权"还要用。
+ - namespace 的"作用域"不是"文件顺序"：可跨文件延续、跨块合并。
+
+
常见的坑
+
+ - 头文件里
using namespace std; 会把命名空间污染带给所有 include 它的
+ 地方——只在 .cpp 用，或全程写限定名。
+
+
出处：p01/ch04/（类与对象各节）、
+ p01/ch03/namespace_syntax.cpp，
+ 对照 docs/ERRATA.md
-
+
- 模块 B · 练习 95min
+ 上午 · 课堂练习 11:00–12:00（工程师指导、答疑）
动手：走一遍真实构建流程 练
@@ -358,13 +157,165 @@ cmake --build build # 144 个目标全绿
模块 A · 讲授 35min
- 项目结构 / 信号槽 讲
-
- - 最小 Qt 程序结构
- - 控件创建与显示
- - 内置 / 自定义 / lambda 信号槽
-
+ 上午 · 讲授 08:30–11:00
+ Qt 概述 / 创建项目 / 第一个程序 讲
- 最小 Qt 程序：核心概念 讲
+ Qt 概述 讲
核心概念
- QApplication 是整个进程唯一的"事件循环拥有者"——app.exec()
- 阻塞在这里进入事件循环，不断从操作系统取事件（鼠标/键盘/定时器/重绘请求）分发出去，
- 程序的"活着"就是这个循环在转，不是运行完就退出的普通程序。Q_OBJECT 宏触发 moc（meta-object compiler）在编译前生成额外代码——
- 信号槽、属性系统、qobject_cast 等运行时反射能力都靠这份生成代码实现，
- 这是 Qt 自己的预处理步骤，不是普通 C++ 语法。- Qt = 跨平台 C++ 应用框架：一份代码，Windows/Linux/macOS 原生编译；模块化组织——
+ 本课程用
Core（对象/容器/IO）、Gui、Widgets（桌面控件）。
+ - 版本纪律：本实训统一用隔离安装的 Qt 5.14.2（
.qt514/），不碰系统
+ Qt——顶层 CMakeLists 有版本断言，连错版本直接 FATAL_ERROR。这是工程上
+ "锁依赖版本"的真实示范。
+
+
+ 出处：仓库根 CMakeLists.txt（版本断言一节）
+
+
+
+ 创建 Qt 项目（CMake 方式） 讲
+ find_package(Qt5 5.14 REQUIRED COMPONENTS Core Gui Widgets)
+add_executable(minimal_qt_app minimal_qt_app.cpp)
+set_target_properties(minimal_qt_app PROPERTIES AUTOMOC ON)
+target_link_libraries(minimal_qt_app PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets)
+
+
核心概念
+
+ - 昨天的
find_package 概念今天落地：CMake 按 CMAKE_PREFIX_PATH
+ 找到 Qt；AUTOMOC 自动跑 moc（元对象编译器）——它为 Q_OBJECT
+ 类生成信号槽所需的代码，下一页就见到。
+
+
出处：p03/CMakeLists.txt、
+ p03/ch02/CMakeLists.txt
+
+
+
+ 第一个 Qt 小程序 讲
+
+
核心概念
+
+ QApplication 是唯一的事件循环拥有者，app.exec() 阻塞进入
+ 事件循环分发系统事件；Q_OBJECT 宏触发 moc 生成信号槽/属性系统所需的元对象代码。
常见的坑
- - 一个进程只能有一个
QApplication 实例，创建第二个直接崩溃/未定义行为。
- - 忘记调用
exec()：窗口一闪而过就退出，因为根本没进入事件循环。
- - 类里用了信号槽却忘记写
Q_OBJECT：编译能过，链接阶段报
- undefined reference——报错信息完全不提示"缺宏"，是新手最常踩的坑。
+ - 一个进程只能有一个
QApplication；忘记 exec() 窗口一闪而过；
+ - 用了信号槽却忘
Q_OBJECT：报 undefined reference——
+ 链接错误（昨天那页！），报错完全不提"缺宏"，知道这一条能省一小时。
+ 出处：p03/ch02/minimal_qt_app.cpp
- 最小 Qt 程序：QApplication + exec() 讲
-
-class Widget : public QWidget {
- Q_OBJECT // 用到信号槽/属性系统的类都要有这个宏（触发 moc 代码生成）
-public:
- Widget(QWidget* parent = nullptr) : QWidget(parent) {}
-};
-
-int main(int argc, char* argv[]) {
- QApplication app(argc, argv); // 整个程序唯一的 QApplication
- Widget w;
- w.show();
- return app.exec(); // 进入事件循环，程序在这里“活着”
-}
-
- 出处：p03/ch02/minimal_qt_app.cpp（注意仓库版本额外注入了
- QTimer::singleShot 200ms 自动退出，便于离屏自动化验证，真实项目不需要这一行）
-
-
-
- 控件创建：对象树与父子所有权 讲
+ 控件创建与对象树 讲
核心概念
- - QObject 有一套"对象树"父子所有权模型：给控件传入
parent 后，
- parent 被销毁时会自动 delete 所有子对象——这就是为什么 Qt 代码里到处是
- new 却几乎不见 delete。
- - 两种写法（先构造后设属性 / 构造时一次性传参）本质相同，父对象的作用一样。
+ - QObject 对象树 = Qt 的所有权答案（接昨天"谁负责 delete"）：创建控件把 parent
+ 传进去，parent 析构自动 delete 所有子对象——整棵树只需要管好根。
常见的坑
- - 忘记传
parent：控件永远不会自动释放（真实内存泄漏），也不会自动出现在
- 窗口里（没有父容器就没有布局位置）。
- - 用
move() 手动摆放坐标的控件，一旦外层套上布局管理器，手动坐标会被
- 布局在下次刷新时覆盖——这是"混用绝对定位和布局"最常见的诡异 bug 来源。
+ - 忘记传 parent：对象没人管，真实内存泄漏；
+ move() 手动定位的控件一旦套上布局会被布局接管覆盖。
+ 出处：p03/ch03/button_creation.cpp
- 控件创建：两种写法 讲
+ ★ 栈对象与父子所有权打架 讲
-// 第一种：先构造再设属性
-QPushButton* btn = new QPushButton;
-btn->setParent(this);
-btn->setText(QStringLiteral("德玛西亚"));
-btn->move(100, 100);
-
-// 第二种：构造时指定文本与父亲
-QPushButton* btn2 = new QPushButton(QStringLiteral("孙悟空"), this);
+QPushButton btn("我建在栈上"); // 先声明 → 后析构
+QWidget window; // 后声明 → 先析构
+btn.setParent(&window);
+// 离开作用域：window 先析构 → 父子树 delete &btn（栈地址！）→ 崩溃
- 出处：p03/ch03/button_creation.cpp
-
-
-
- 信号槽：观察者模式 + moc 讲
核心概念
- - 信号槽本质是"观察者模式"的 Qt 实现：发送者不知道、也不关心谁在监听，彻底解耦发送方
- 和接收方——这和"直接调用某个函数"是完全不同的设计取向。
- connect() 背后依赖 moc 生成的元对象信息做类型检查：新语法
- &Class::signal 是编译期检查，字符串旧语法
- SIGNAL()/SLOT() 是运行时检查，容易悄悄连接失败。- 连接方式分 Direct（同线程直接调用）/ Queued（跨线程排队，下次事件循环处理）/
- Auto（默认，同线程 Direct、跨线程自动 Queued）——Day4 讲 QThread 时还会用到。
+ - 父子树会 delete 子对象 ⇒ 交给父子树管的对象必须建在堆上。一个对象只能有
+ 一个所有者：给了 parent，就不能再由栈/智能指针/手动 delete 管。
常见的坑
- - 旧的字符串语法
SIGNAL(clicked()) 函数名/参数类型写错不会编译报错，
- 只会运行时"连接失败"且经常没有提示——能用新语法就不用旧语法，编译期就能发现问题。
- - 重载信号（如右侧例子的两个
hungry()）不加 QOverload
- 消歧义，编译器不知道该连哪个重载，直接报错。
+ - 声明顺序反过来时这段代码"恰好不崩"——不要赌析构顺序的运气，规则只有一条。
+ 现场演示：
tools/run_qt.sh qt_pitfall_stack_widget --crash（真崩给你看）。
-
-
-
- 信号槽：内置 / 自定义 / 重载消歧义 讲
-
-class Teacher : public QObject {
- Q_OBJECT
-signals:
- void hungry(); // 无参信号
- void hungry(QString food); // 带参信号（重载）
-public slots:
- void classIsOver(){ emit hungry(); emit hungry(QString("汉堡")); }
-};
-// 连接重载信号时必须用 QOverload 显式指定版本
-connect(t, QOverload<>::of(&Teacher::hungry), s, QOverload<>::of(&Student::treat));
-connect(t, QOverload<QString>::of(&Teacher::hungry), s, QOverload<QString>::of(&Student::treat));
-
- 出处：p03/ch04/custom_signal_slot.cpp；
- lambda 槽 + 值捕获/引用捕获对比见
- lambda_signal_slot.cpp
+ 复现示例：examples/pitfall_stack_widget/
+ （README）
-
+
- 
- 
-