# qt_cpp_lab

**Repository Path**: wangdong_cmcc/qt_cpp_lab

## Basic Information

- **Project Name**: qt_cpp_lab
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-01
- **Last Updated**: 2026-10-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Qt/C++ 学习实验室

本仓库用于学习 Qt Widgets、C++ 和 CMake。仓库包含一个综合示例工程，以及三个可以分别配置、构建和运行的阶段练习工程。各工程相互独立，不依赖其他业务项目。

## 仓库结构

```text
qt_cpp_lab/
├── CMakeLists.txt                 # 综合示例工程的 CMake 配置
├── main.cpp                       # 应用入口
├── mainwindow.h / mainwindow.cpp  # 主窗口、控件、JSON 配置和日志界面
├── taskworker.h / taskworker.cpp  # 后台任务工作对象
├── DEVELOPMENT_GUIDE.md           # 综合工程学习路线、阶段目标和类职责
├── .vscode/
│   └── c_cpp_properties.json      # C/C++ IntelliSense 配置
├── qt_cpp_stage0/                 # 最小 Qt Widgets 窗口
├── qt_cpp_stage1/                 # 应用入口和事件循环练习
└── qt_cpp_stage2/                 # 主窗口、选项卡和布局练习
```

各阶段目录是独立工程，每个目录包含自己的 `CMakeLists.txt`、`README.md` 和 `DEVELOPMENT_GUIDE*.md`。`stage2` 还包含独立的 `mainwindow.h` 和 `mainwindow.cpp`。目录中的 `build/` 是 CMake 生成的构建目录，不是源代码的一部分。

## 工程说明

| 工程 | 内容 | 入口与主要文件 |
|---|---|---|
| 根目录综合示例 | 问候控件、JSON 配置读写、Model/View 日志、后台进度任务 | `main.cpp`、`mainwindow.cpp`、`taskworker.cpp` |
| [`qt_cpp_stage0`](qt_cpp_stage0/README.md) | 最小 Widgets 窗口，验证 CMake、Qt 依赖和程序启动 | `qt_cpp_stage0/main.cpp` |
| [`qt_cpp_stage1`](qt_cpp_stage1/README.md) | `QApplication`、窗口显示和事件循环 | `qt_cpp_stage1/main.cpp` |
| [`qt_cpp_stage2`](qt_cpp_stage2/README.md) | `QMainWindow`、中央控件、三个选项卡和页面布局 | `qt_cpp_stage2/main.cpp`、`qt_cpp_stage2/mainwindow.cpp` |

完整学习顺序、阶段验收要求、类职责和线程通信关系见[综合工程开发指南](DEVELOPMENT_GUIDE.md)。阶段工程的具体操作和验收项见各自目录中的 README 与开发指南。

## 根工程构建与运行

以下命令在仓库根目录的 PowerShell 终端执行，示例使用 Qt 5.14.2 `mingw73_64` 和配套 MinGW 7.3：

```powershell
cmake -S . -B build -G "MinGW Makefiles" -DCMAKE_PREFIX_PATH="C:/Qt/Qt5.14.2/5.14.2/mingw73_64"
cmake --build build
& "C:/Qt/Qt5.14.2/5.14.2/mingw73_64/bin/windeployqt.exe" --compiler-runtime ".\build\qt_cpp_lab.exe"
.\build\qt_cpp_lab.exe
```

如果 Qt 安装位置不同，请同步调整 `CMAKE_PREFIX_PATH` 和 `windeployqt.exe` 路径。Qt 套件、C++ 编译器和 CMake 生成器必须来自兼容的工具链。构建某个阶段工程时，先进入对应的 `qt_cpp_stageN` 子目录，再按该目录 README 中的命令执行；不要共用根工程的 `build/` 目录。

## VS Code

建议将仓库根目录作为 VS Code 工作区，并使用 CMake Tools 选择与 Qt 套件匹配的编译器。`.vscode` 当前只提供 C/C++ IntelliSense 配置；调试程序还需配置匹配的 C++ 调试器和 MinGW GDB。