Qt 示例窗口默认不再自动退出，仅离屏验证时自动退出

p03/ 生成产物与 docs/teaching/examples/ 手工示例里的 QTimer::singleShot
自动退出逻辑，从"始终 200ms 后退出"改为"仅当 QT_QPA_PLATFORM=offscreen
时才退出"。正常运行（有显示环境）窗口保持打开，需手动关闭；离屏自动化
验证（tools/run_qt.sh + QT_QPA_PLATFORM=offscreen）行为不变。

p03/ 改动来自重新生成 tools/gen_part3.py（AUTO_QUIT 常量加 qgetenv 判断），
未手改生成产物。QCoreApplication 控制台风格示例（qfile_basic 等）本就
执行完即退出，不受影响。

p03/ch02/minimal_qt_app.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954515:0]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -22,8 +22,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     Widget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch03/button_creation.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954525:0]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -36,8 +36,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch04/builtin_signal_slot.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954527:0]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -28,8 +28,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch04/custom_signal_slot.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954527:2]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -60,8 +60,11 @@ public:
 int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     MyWidget w; w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch04/lambda_signal_slot.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954527:6]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -34,8 +34,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch05/central_widget.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954529:5]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -25,8 +25,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoMainWindow w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch05/dock_widget.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954529:4]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -29,8 +29,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoMainWindow w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch06/file_dialog.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954535:12]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -60,8 +60,11 @@ private slots:
 int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     MainWindow w; w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch06/message_box_custom.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954535:11]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -47,8 +47,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch06/message_box_question.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954535:10]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -39,8 +39,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch06/modal_dialog.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954535:0]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -28,8 +28,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch06/modeless_dialog_deleteonclose.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954535:3]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -29,8 +29,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch06/modeless_dialog_heap.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954535:2]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -28,8 +28,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch06/modeless_dialog_stack.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954535:1]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -28,8 +28,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch08/custom_widget.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954540:15]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -36,8 +36,11 @@ public:
 int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     SmallWidget w; w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch08/label_movie.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954540:movie]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -29,8 +29,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch08/label_pixmap.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954540:img]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -29,8 +29,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch08/label_text_create.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954540:1]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -25,8 +25,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch08/label_text_html.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954540:2]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -27,8 +27,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     DemoWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch09/event_filter_mainwindow.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954546:6]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -39,8 +39,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     MainWindow w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch09/event_override_customwidget.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954546:2]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -35,8 +35,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     CustomWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch09/mouse_event.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954546:0]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -41,8 +41,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     EventLabel w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch10/paint_device_pixmaps.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954548:2]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -36,8 +36,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     PaintWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch10/paint_device_qimage.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954548:3]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -36,8 +36,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     PaintWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch10/qpainter_basic.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954548:0]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -32,8 +32,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     PaintedWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch10/qpicture_io.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954548:4]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>
@@ -41,8 +41,11 @@ int main(int argc, char* argv[]) {
     QApplication app(argc, argv);
     PaintWidget w;
     w.show();
-    // 离屏/自动化验证：200ms 后自动退出（GUI 模式下不阻塞）
-    QTimer::singleShot(200, &app, &QApplication::quit);
+    // 仅在离屏自动化验证时（QT_QPA_PLATFORM=offscreen）200ms 后自动退出；
+    // 正常运行（有显示环境）窗口保持打开，不自动退出。
+    if (qgetenv("QT_QPA_PLATFORM") == "offscreen") {
+        QTimer::singleShot(200, &app, &QApplication::quit);
+    }
     return app.exec();
 }
 

p03/ch11/qdatastream_io.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954552:data]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>

p03/ch11/qfile_basic.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954552:0]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QCoreApplication>

p03/ch11/qtextstream_io.cpp

@@ -4,7 +4,7 @@
 //  原文片段：[58954552:text]
 //  说明：本文件由 gen_part3.py 从 wiki 片段生成（必要时补 main/QApplication
 //        外壳、include、修正笔误）。详见 docs/ERRATA.md。
-//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>
+//        离屏验证：QT_QPA_PLATFORM=offscreen tools/run_qt.sh <target>（自动退出）
 // ============================================================================
 
 #include <QApplication>