Qt Creator不支持直接新建文件夹并自动纳入项目管理，所有文件必须显式声明在.pro文件中；添加C++类时会自动处理路径和SOURCES/HEADERS条目，而手动添加子文件夹中的文件需编辑.pro文件并运行qmake。

Qt Creator 本身不支持直接“新建文件夹”并自动纳入项目管理，所有文件必须显式声明在 .pro 文件里，否则编译器根本看不到它们。

添加新 C++ 类（最常用场景）

这是日常开发中添加头文件和源文件最稳妥的方式，Qt Creator 会自动处理路径、SOURCES 和 HEADERS 条目，并生成基础代码结构：

• 右键项目名 → 添加新文件… → 选 C++ Class
• 输入类名（如 MyDialog），基类可选 QDialog 或 QWidget
• 勾选 创建 UI 文件（如果需要可视化界面）
• 完成之后，.pro 文件里会自动追加类似这样的行：
  HEADERS += mydialog.h
SOURCES += mydialog.cpp
  （注意：路径是相对项目根目录的，不是相对子文件夹）

手动添加已有 .h/.cpp 到子文件夹

当你把文件拖进工程目录的子文件夹（比如 Dialogs/）后，Qt Creator 不会自动发现它们 —— 必须手动编辑 .pro 文件：

C++

"空空如也"

下载

• 在文件系统中创建子文件夹（如 Dialogs），把 login.h 和 login.cpp 放进去
• 打开 .pro 文件，在 HEADERS 和 SOURCES 变量中分别添加完整路径：
  HEADERS += Dialogs/login.h
SOURCES += Dialogs/login.cpp
• 不要用通配符如 Dialogs/*.h，qmake 对通配符支持有限，尤其 Windows 下容易漏文件
• 改完保存，右键项目 → 运行 qmake（否则 Qt Creator 编辑器可能仍标红、补全失效）

为什么头文件加了却报 “undefined reference”？

常见原因是只加了 HEADERS，漏了对应的 SOURCES：

• HEADERS 仅影响头文件包含路径和编辑器索引（补全、跳转）
• SOURCES 才决定哪些 .cpp 被编译进最终目标 —— 缺了它，函数声明有、定义没编译，链接时就崩
• 检查 .pro 中是否成对出现：
  HEADERS += utils.h
SOURCES += utils.cpp
• 如果用了 Q_OBJECT 宏但没运行 qmake，moc 也不会生成，同样导致链接失败

INCLUDEPATH 和 LIBS 是另一回事

这些变量控制的是第三方头文件和库，跟项目自身源码组织无关：

• INCLUDEPATH += ./third_party/include：让 #include <xxx.h> 能找到外部头文件
• LIBS += -L./lib -lmylib：链接外部静态/动态库
• 项目内自建的 .h 不需要加到 INCLUDEPATH —— 默认已包含项目根目录

真正容易被忽略的是：改完 .pro 后必须手动触发 qmake，否则 Qt Creator 的构建系统和编辑器状态不同步；另外，路径一律用正斜杠 /，哪怕在 Windows 上，qmake 对反斜杠 \ 解析不稳定。