Update Windows build documentation

readme.md

@@ -20,72 +20,219 @@
 - 图像分类：根据平均亮度和主色通道给出简单分类，同时显示目标数量。
 - 线程处理：图像处理工作对象运行在 `QThread` 中，避免阻塞界面。
 
-## Windows 编译运行
+## Windows 构建说明
 
-本工程用于构建 Windows 桌面应用程序。建议使用 Qt Creator 打开 `CMakeLists.txt` 构建，编译器可选择 MSVC 或 MinGW，但 Qt、OpenCV 和编译器位数必须一致，例如全部使用 64 位。
+本工程使用 CMake 管理，目标是构建 Windows 桌面应用程序 `QtOpenCVImageTool.exe`。推荐使用 **MSVC 64 位**，因为 OpenCV 官方 Windows 预编译包通常就是 MSVC 版本，配置最省事。
 
-### 环境准备
+构建时请保持三者一致：
 
-1. 安装 Qt for Windows，推荐 Qt 6.x，并安装对应的 MinGW 64-bit 或 MSVC 64-bit 组件。
-2. 安装 OpenCV for Windows，或自行用相同编译器编译 OpenCV。
-3. 安装 CMake。Qt Creator 通常会自带可用的 CMake。
+- 编译器一致：MSVC 对 MSVC，MinGW 对 MinGW。
+- 位数一致：建议全部使用 64 位。
+- Qt、OpenCV、CMake 使用同一套构建环境。
 
-### Qt Creator 构建
+如果使用 MSVC，则不要混用 MinGW 版 Qt；如果使用 MinGW，则不要直接使用 OpenCV 官方 MSVC 预编译包。
+
+### 需要安装的软件
+
+1. Visual Studio 2022 或 Visual Studio 2022 Build Tools
+
+安装时勾选：
+
+```text
+Desktop development with C++
+MSVC v143 x64/x86 build tools
+Windows 10 SDK 或 Windows 11 SDK
+C++ CMake tools for Windows
+```
+
+安装完成后，系统中应能找到类似路径：
+
+```text
+C:\Program Files\Microsoft Visual Studio\2022\Community
+C:\Program Files\Microsoft Visual Studio\2022\BuildTools
+```
+
+2. Qt for Windows
+
+使用 Qt Online Installer 安装 Qt。推荐安装 Qt 6.x，并勾选 MSVC 64 位组件，例如：
+
+```text
+Qt 6.6.x
+MSVC 2019 64-bit 或 MSVC 2022 64-bit
+Qt Creator
+```
+
+安装完成后，Qt 路径通常类似：
+
+```text
+C:\Qt\6.6.0\msvc2019_64
+C:\Qt\6.6.0\msvc2022_64
+```
+
+该目录下应存在：
+
+```text
+C:\Qt\6.6.0\msvc2019_64\lib\cmake\Qt6\Qt6Config.cmake
+```
+
+3. OpenCV for Windows
+
+可以使用 OpenCV 官方 Windows 包。解压或安装到例如：
+
+```text
+C:\opencv
+```
+
+常见的 CMake 配置路径是：
+
+```text
+C:\opencv\build\x64\vc16\lib
+```
+
+该目录下应存在：
+
+```text
+C:\opencv\build\x64\vc16\lib\OpenCVConfig.cmake
+```
+
+4. CMake
+
+如果安装 Visual Studio 时勾选了 CMake 工具，通常已经够用。也可以单独安装 CMake for Windows。命令行检查：
+
+```bat
+cmake --version
+```
+
+### 推荐方式：Qt Creator 构建
 
 1. 打开 Qt Creator。
-2. 选择“打开项目”，打开本目录下的 `CMakeLists.txt`。
-3. 选择 Windows Kit，例如 `Desktop Qt 6.x MinGW 64-bit` 或 `Desktop Qt 6.x MSVC 64-bit`。
-4. 如果 CMake 找不到 OpenCV，在 CMake 配置中加入：
+2. 选择“打开项目”，打开本目录的 `CMakeLists.txt`。
+3. 选择 Windows Kit，例如：
+
+```text
+Desktop Qt 6.x.x MSVC 2019 64-bit
+Desktop Qt 6.x.x MSVC 2022 64-bit
+```
+
+4. 如果 CMake 找不到 OpenCV，在 Qt Creator 的 CMake 配置项中添加：
 
 ```text
 OpenCV_DIR=C:/opencv/build/x64/vc16/lib
 ```
 
-实际路径以你的 OpenCV 安装目录为准。MinGW 自编译 OpenCV 时，应填写包含 `OpenCVConfig.cmake` 的目录。
+5. 配置完成后点击“构建”。
+6. 构建成功后会生成 `QtOpenCVImageTool.exe`。
+7. 在 Qt Creator 中点击“运行”即可启动程序。
 
-5. 点击“构建”并运行。
+### 命令行构建：MSVC
 
-### 命令行构建示例
+打开开始菜单中的：
 
-也可以直接使用项目提供的 `build_windows.bat`：
-
-```bat
-build_windows.bat C:\Qt\6.6.0\mingw_64 C:\opencv\build "MinGW Makefiles"
+```text
+x64 Native Tools Command Prompt for VS 2022
 ```
 
-或 MSVC：
+进入工程目录，例如：
+
+```bat
+cd /d D:\QtOpenCVImageTool
+```
+
+使用项目提供的脚本构建：
 
 ```bat
 build_windows.bat C:\Qt\6.6.0\msvc2019_64 C:\opencv\build\x64\vc16\lib "Visual Studio 17 2022"
 ```
 
-MinGW 示例：
+如果你的 Qt 是 MSVC 2022 版本，路径可改为：
 
 ```bat
-mkdir build
-cd build
-cmake .. -G "MinGW Makefiles" -DCMAKE_PREFIX_PATH=C:\Qt\6.6.0\mingw_64 -DOpenCV_DIR=C:\opencv\build
-cmake --build . --config Release
+build_windows.bat C:\Qt\6.6.0\msvc2022_64 C:\opencv\build\x64\vc16\lib "Visual Studio 17 2022"
 ```
 
-MSVC 示例：
+也可以手动执行 CMake：
 
 ```bat
-mkdir build
-cd build
+mkdir build-windows
+cd build-windows
 cmake .. -G "Visual Studio 17 2022" -A x64 -DCMAKE_PREFIX_PATH=C:\Qt\6.6.0\msvc2019_64 -DOpenCV_DIR=C:\opencv\build\x64\vc16\lib
 cmake --build . --config Release
 ```
 
-### 运行和发布
+MSVC 生成的 exe 通常位于：
 
-在 Windows 上运行生成的 `QtOpenCVImageTool.exe` 时，需要能找到 Qt 和 OpenCV 的 DLL。调试阶段可在 Qt Creator 中直接运行；发布时可使用：
-
-```bat
-windeployqt QtOpenCVImageTool.exe
+```text
+build-windows\Release\QtOpenCVImageTool.exe
 ```
 
-然后把 OpenCV 的运行库 DLL 一并复制到 exe 所在目录，例如 `opencv_world*.dll` 或相关 `opencv_*.dll`。
+### 命令行构建：MinGW
+
+如果使用 MinGW，需要安装 MinGW 版 Qt，并准备 MinGW 编译出来的 OpenCV。不要把 MSVC 版 OpenCV 直接给 MinGW 使用。
+
+示例：
+
+```bat
+build_windows.bat C:\Qt\6.6.0\mingw_64 C:\opencv-mingw\install "MinGW Makefiles"
+```
+
+手动构建：
+
+```bat
+mkdir build-windows
+cd build-windows
+cmake .. -G "MinGW Makefiles" -DCMAKE_PREFIX_PATH=C:\Qt\6.6.0\mingw_64 -DOpenCV_DIR=C:\opencv-mingw\install
+cmake --build . --config Release
+```
+
+MinGW 生成的 exe 通常位于：
+
+```text
+build-windows\QtOpenCVImageTool.exe
+```
+
+### 运行和发布
+
+构建出来的 `QtOpenCVImageTool.exe` 运行时需要 Qt 和 OpenCV 的 DLL。开发阶段可以直接在 Qt Creator 中运行；如果要单独拷贝给别人运行，需要把依赖 DLL 一起放到 exe 目录。
+
+MSVC Release 示例：
+
+```bat
+cd build-windows\Release
+C:\Qt\6.6.0\msvc2019_64\bin\windeployqt.exe QtOpenCVImageTool.exe
+copy C:\opencv\build\x64\vc16\bin\opencv_world*.dll .
+```
+
+如果 OpenCV 不是 `opencv_world*.dll`，则复制对应的 `opencv_*.dll` 到 exe 所在目录。
+
+MinGW 示例：
+
+```bat
+cd build-windows
+C:\Qt\6.6.0\mingw_64\bin\windeployqt.exe QtOpenCVImageTool.exe
+copy C:\opencv-mingw\bin\opencv_*.dll .
+```
+
+### 常见问题
+
+1. `Could not find Qt6`
+
+说明 `CMAKE_PREFIX_PATH` 没有指向 Qt 安装目录。请确认路径类似：
+
+```text
+C:\Qt\6.6.0\msvc2019_64
+```
+
+2. `Could not find OpenCV`
+
+说明 `OpenCV_DIR` 没有指向包含 `OpenCVConfig.cmake` 的目录。请搜索 `OpenCVConfig.cmake`，并把它所在目录传给 CMake。
+
+3. 程序启动时报缺少 DLL
+
+请运行 `windeployqt`，并把 OpenCV 的 DLL 复制到 exe 所在目录。
+
+4. 链接时报 MSVC/MinGW 相关错误
+
+通常是 Qt、OpenCV、编译器不匹配。MSVC 工程必须使用 MSVC 版 Qt 和 MSVC 版 OpenCV；MinGW 工程必须使用 MinGW 版 Qt 和 MinGW 版 OpenCV。
 
 ## WSL 中交叉编译 Windows 程序