2. 开发环境搭建：Qt Creator配置、CMake与qmake选择、编译器设置、调试环境配置
说实话，很多新手学Qt，上来就写代码，结果卡在环境搭建上。我见过太多人花了一整天装环境，最后连个Hello World都跑不起来。嗯，这一章咱们就把这事彻底搞定。
核心要点：开发环境搭建不是一次性的工作。随着项目推进，你可能需要反复调整配置。所以，理解每个配置项的含义，比机械地跟着教程点下一步重要得多。
2.1 Qt Creator 配置：别小看这个IDE
Qt Creator 是官方IDE，我用它快十年了。说实话，它比不上Visual Studio那么花哨，但胜在轻量和专注。我个人习惯把界面调成深色主题，眼睛舒服点。
安装完成后，第一件事是配置Kit。什么是Kit？说白了就是「编译器 + Qt版本 + 调试器」的组合体。你想想看，没有Kit，Qt Creator不知道用什么工具链去编译你的代码。
配置路径：工具 → 选项 → Kits
这里我踩过一个坑：有一次我同时装了Qt 5.15和Qt 6.2，结果默认Kit指向了Qt 6，但我的项目依赖的第三方库只支持Qt 5。编译报错查了半天，最后发现是Kit选错了。所以，每次新建项目前，先确认Kit对不对。
小技巧：给Kit起个容易识别的名字，比如「Qt 5.15.2 MSVC2019 64bit」。别用默认的「Desktop Qt 5.15.2 MSVC2019 64bit」，太长了，看着眼晕。
2.2 CMake 与 qmake：到底选哪个？
这个问题我几乎每次培训都会被问到。我的回答很简单：新项目用CMake，老项目维护用qmake。
为什么会这样？因为Qt官方从Qt 6开始，已经把CMake作为首选构建系统了。qmake虽然还能用，但官方已经停止大版本更新。说白了，qmake正在被淘汰。
我在项目中遇到过这样的情况：一个用了五年的老项目，全是qmake写的.pro文件。迁移到CMake花了整整两周。所以，如果你现在开始学，直接上CMake，别给自己挖坑。
| 对比项 | qmake | CMake |
|---|---|---|
| 学习曲线 | 简单，.pro文件很直观 | 中等，语法稍复杂 |
| 跨平台能力 | 一般，主要服务Qt | 强，支持几乎所有平台 |
| 第三方库集成 | 麻烦，需要手动配置 | 方便，find_package直接搞定 |
| 官方推荐 | 已不推荐 | 强烈推荐 |
来看一个最简单的CMakeLists.txt示例：
cmake_minimum_required(VERSION 3.16)
project(MyCustomWidget VERSION 1.0 LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)
find_package(Qt6 REQUIRED COMPONENTS Widgets)
add_executable(MyCustomWidget main.cpp widget.cpp widget.h)
target_link_libraries(MyCustomWidget PRIVATE Qt6::Widgets)
注意那三行 AUTOMOC、AUTORCC、AUTOUIC。这是Qt的元对象编译器、资源编译器和UI编译器。不开启的话，信号槽、资源文件、UI文件都会出问题。我曾经忘记开 AUTOMOC，结果信号槽死活连不上，查了一下午。
警告：如果你用CMake，记得在CMakeLists.txt里加上 set(CMAKE_AUTOMOC ON)。否则，包含Q_OBJECT宏的类会编译失败，报错信息还特别隐晦。
2.3 编译器设置：MSVC vs MinGW vs GCC
编译器选择取决于你的目标平台。我简单总结一下：
- Windows平台：推荐MSVC（Visual Studio的编译器）。性能好，调试信息完整。MinGW虽然也能用，但调试体验差一截。
- Linux平台：用GCC，没得选。不过GCC对C++标准的支持很积极，用起来省心。
- macOS平台：用Clang，苹果官方推荐。和Xcode配合得天衣无缝。
我个人习惯在Windows上用MSVC 2019。为什么不是2022？因为有些第三方库还没跟上2022的ABI。你想想看，一个库链接不上，整个项目就废了。所以，编译器版本不是越新越好，稳定才是王道。
配置路径：工具 → 选项 → Kits → 选择Kit → 编译器下拉框
提示：如果你同时装了多个编译器版本，可以在「编译器」标签页里手动添加。Qt Creator会自动检测大部分已安装的编译器，但偶尔会漏掉。手动添加时，指定编译器的可执行文件路径即可。
2.4 调试环境配置：别让bug跑了
调试是开发中最重要的环节之一。没有调试器，你就像蒙着眼睛写代码。Qt Creator支持三种调试器：
- CDB（Windows）：配合MSVC使用，功能强大
- GDB（Linux/macOS）：经典调试器，支持所有平台
- LLDB（macOS）：苹果生态的首选
配置路径：工具 → 选项 → Debugger
我曾经遇到一个诡异的问题：程序在Debug模式下运行正常，Release模式下就崩溃。查了两天，最后发现是变量未初始化。Debug模式下编译器会自动清零，Release模式不会。所以，一定要在两种模式下都跑一遍测试。
调试环境配置的几个关键点：
- 符号文件路径：确保调试器能找到.pdb文件（Windows）或调试符号（Linux）。否则，你看到的堆栈全是地址，没有函数名。
- 源码路径映射：如果你在远程编译，本地调试，需要设置源码路径映射。否则调试器找不到源码文件。
- 断点条件：学会设置条件断点。比如只当变量等于某个值时中断，能省大量时间。
避坑指南：我曾经在调试自定义控件时，发现断点根本不会命中。查了半天，原来是CMakeLists.txt里忘了加 -g 编译选项。Debug模式下默认会加，但如果你手动改了编译选项，记得加上。命令是：set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -g")
2.5 知识体系总览
下面这张图，是我自己总结的环境搭建知识体系。你跟着这个脉络走，基本不会迷路。
这张图把环境搭建拆成了四个模块。你按照这个顺序来配置，基本不会漏掉什么。我个人建议先配编译器，再配Qt版本，最后配调试器。因为调试器依赖编译器生成的符号文件，顺序反了容易出问题。
最后说一句：环境搭建遇到问题，别硬扛。去Qt官方论坛搜一下，或者看看Qt Creator自带的「帮助 → 关于插件」里有没有你需要的功能。我当年就是靠翻论坛学会的，现在轮到你了。