我在不少群里都看到过这样的求助：新建一个 Qt 工程，结果左边项目树里孤零零躺着一个.pro文件，源文件一个都不见；或者从别人那拷来一个工程，打开后同样只有.pro，连main.cpp都找不到。提问的兄弟往往第一反应就是：我 Qt 是不是没装好？要不要重装？其实这个现象跟 Qt 安装包基本无关，绝大多数是工程创建方式、打开方式、路径解析三者之间某一步出了问题。下面我按新建、打开、恢复三个场景把这个事彻底拆开讲，最后还会带上那个 Windows + MSVC 下常见的:-1: error: dependent '..\..\..\qt\5.15.2\msvc2019_64\include\...报错。不管你是刚学 Qt 的新人，还是带了几年项目的老人，被这个现象困扰时顺着我的排查顺序走一遍，大概率几分钟内就能把工程救回来。

1. 先分清你遇到的是"三种只有 .pro"中的哪一种

1.1 新建和打开是两条完全不同的线索

用户的原话是"打开或者创建工程只有一个 .pro 文件"，注意这个"或者"。我排查问题时第一件事永远不是看代码，而是先问一句：你是新建完就这样，还是打开别人的工程才这样？因为这两种情况的成因几乎不重叠。

新建后只剩.pro，多半是模板选错了，或者工程目录本身有问题；打开后只剩.pro，那就要往打开方式、.pro.user配置、源文件路径漂移这三方面去查。把这两件事混在一起找原因，容易越找越乱。我在公司带新人的时候见过一个人重装了三次 Qt，最后发现他只是用记事本打开了一个.pro，压根没有以"工程"方式加载——这就是典型的"线索没分清楚"。

1.2 还有一种是目录里确实只剩一个 .pro

第三种场景比较少见，但更让人懵：你去文件管理器里看，整个目录下物理文件真的只有一个.pro，连构建输出文件夹都没有。这种情况通常是别人从代码片段里复制了一段.pro内容保存下来，或者某个压缩包在解压时漏掉了源文件，又或者是某人误删了.cpp/.h但留下了.pro。

判断办法很简单：用文件管理器打开工程目录，查看是不是真的只有一个文件。如果确实如此，那不管 Qt Creator 怎么打开都救不回来，只能按第六章讲的方法手动把源文件补回去。如果目录里明明有.cpp/.h但 Qt Creator 不显示，才是 Qt Creator 的问题。

1.3 用一张表快速对号入座

我把三类常见现象、典型原因和第一步排查动作列成了一张表，你对照一下就能少走弯路：

这张表我建议你截图留着。遇到"只有一个 .pro"时先在这三个格子里找自己属于哪一行，再去读下面的对应章节，比通读全篇更省时间。

2. 新建工程"只生成了.pro"：多半是你选错了模板

2.1 Empty qmake Project 和 Qt Widgets Application 有什么区别

新建 Qt 工程时，Qt Creator 会弹出一大串模板。很多人直接点了列表里第一项，或者看到"qmake"就以为是对的模板，结果选中的其实是Empty qmake Project（空qmake项目）。这个模板的设计初衷就是"只给你生成一个 .pro，所有文件都自己加"，所以它生成的目录里只有 .pro 是正常现象，不是 Qt 出问题了。

如果你想要一个带窗口、能直接跑起来的程序，应该选Qt Widgets Application（传统控件界面程序），或者Qt Quick Application（QML 界面程序）。这两个模板会在生成 .pro 的同时自动创建main.cpp、mainwindow.cpp、mainwindow.h和可选的.ui文件。我见过不少新同事建了空工程后跑来问我为什么编译报错，最后发现只是缺一个 main.cpp，补上之后工程立刻就能跑了。

2.2 在空工程里补齐源文件的正确姿势

如果你确实就是用了空 qmake 项目模板，那不需要重来，往里面补文件就行。在左侧项目树里右键.pro文件，选择Add New...或者在中文界面下选择"添加新文件"，然后按下面的顺序操作：

1. 选择C++分类下的C++ Source File，先添加main.cpp；
2. 如果后续要写界面，再添加一个C++ Class，类名填MainWindow，基类选QMainWindow；
3. 需要界面文件的话，在添加类时勾选"生成 .ui 文件"。

这样操作的好处是 Qt Creator 会自动把SOURCES += main.cpp、HEADERS += mainwindow.h这些条目写进.pro，你不用手动维护文件列表。我见过有人用记事本手动改.pro，写错了缩进或者路径少了一个斜杠，编译时一脸懵。所以尽量别手写，让 IDE 自己写。

2.3 新建向导里的路径暗坑

新建工程时，工程目录如果放在中文路径、带空格的深层路径，或者放在只读目录、U 盘里，都有可能出现"只生成了 .pro"的假象。qmake 在 Windows 上对中文路径的支持时好时坏，尤其是配合 MSVC 套件时，有时候向导能写出.pro文件，但生成main.cpp时失败，于是你得到一个只有.pro的残缺工程。

我自己遇到过一次：同事把工程直接建在桌面下的中文文件夹里，新建向导走完以后目录里只有一个.pro，main.cpp文件数一直是 0，当时还以为是模板坏了。后来我把整个目录挪到D:\dev\demo，重新用向导建一遍，所有文件都正常生成。所以新建工程时顺手把路径定为"纯英文 + 浅层级 + 无空格"，能避开一大半奇怪问题。

2.4 怎么判断新建出来的工程是健康的

新建完成以后，别急着看文件树，先按Ctrl+B编译一次。如果提示编译成功并生成了可执行文件，那不管左侧显示什么，工程本体就是完整的。如果报了No rule to make target或者undefined reference，多半是.pro里的SOURCES没有包含需要的.cpp文件，或者刚刚添加的文件没有被写进.pro。

另外，如果左侧项目树没有立即刷新出新文件，右键工程名选择Run qmake（执行 qmake）就能触发重新解析。Qt Creator 的项目树本质上是 qmake 解析.pro后的可视化结果，执行 qmake 刷新后，该显示的文件就会正常显示了。

3. 打开工程"找不到源码"：打开方式和构建配置在捣鬼

3.1 "打开文件"和"打开项目"完全是两回事

这是"只有一个 .pro" 最常见的热搜根源。很多人在 Windows 资源管理器里双击.pro文件，Qt Creator 确实启动了，也确实把文件打开了，但状态是"文本编辑器打开了一个文件"，而不是"以项目方式加载了这个工程"。

这两种状态有什么区别？以文本方式打开时，左侧显示的是当前文件的目录树，不是 qmake 解析后的项目树。同一个目录下的main.cpp、mainwindow.h并不是不存在，而是没有被组织和高亮，很多人一眼扫过去只看到.pro，就以为工程坏了。判断方法很简单：看左侧顶部有没有"Sources、Headers、Forms、Resources"这几个分组。如果有，才是项目树；如果只是按目录一层层展开的文件夹，说明你只是在浏览目录。

3.2 .pro.user 丢了，工程为什么会变"秃"

如果你已经用了"打开项目"的方式，左侧还是只有.pro，那就要看第二个嫌疑人：.pro.user文件。这个文件在工程目录里，保存着 Qt Creator 针对你这个工程的个性化配置——用的哪个套件、构建目录在哪、打开了哪些文件、调试器怎么配。它通常不会随着工程一起分享给别人，因为.gitignore里一般会把它忽略掉。

当.pro.user缺失时，Qt Creator 会把你当成"第一次打开这个工程"，弹出套件选择框。如果在弹窗里选错了套件，或者根本没有配置可用的 Qt 版本，工程就会加载得不完整，看起来好像只剩一个.pro的空壳。解决方法是：在工具 → 选项 → Kits里确认套件是否有效，然后重新用"打开项目"方式加载，弹窗时勾上正确套件，必要时删除已生成的错误.pro.user让它重新生成。

3.3 从欢迎页打开一个工程的完整动作清单

这里我放一个我自己的标准动作，照着做基本不会变成"只有 .pro"：

1. 启动 Qt Creator，进欢迎页，点左侧的Open按钮；
2. 文件对话框里选中.pro文件，点打开；
3. 如果弹出构建套件选择框，勾上你需要的 Qt 版本，点 OK；
4. 等右侧项目树刷新，确认出现了 Sources/Headers 分组；
5. 右键工程名 →Run qmake，再按Ctrl+B试编译。

这套流程里最容易漏的是第五步。很多人打开工程后不执行 qmake，项目树处于"懒加载"状态，文件列表没有立刻刷新出来。执行一下 qmake 就是个瞬间操作，能省下很多自我怀疑的时间。

3.4 从文件树和项目树的区别判断是不是误开了

我再给你一个更直观的判断办法：项目树顶部有下拉切换器，可以切到"项目"或"文件系统"两种视图。如果你看到的是"文件系统"视图，那它只是把磁盘目录原样映射出来，并不是 qmake 解析后的结果，所以.pro会以普通文件身份排在列表里，其他源码文件也不会按类型分组。

这种情况下就算你看到.cpp文件也不会觉得那是"工程的一部分"，因为你没意识到它们就是同属一个工程的源码。记住：Qt Creator 的工程视图（Project Tree）是以 qmake 的SOURCES、HEADERS变量为准生成的，文件系统视图是以目录为准生成的。只有前者能让你直观看到"这是一个完整的工程"。

4. 文件树空白但源码还在：路径漂移与手写pro排查

4.1 SOURCES/HEADERS 里的路径漂移

第三种高频原因：.pro文件里写了SOURCES += main.cpp，但是main.cpp并不在.pro所在目录下。工程被移动过、复制过，或者从版本库检出到新位置时，这种路径漂移经常发生。qmake 解析到不存在的源文件，会把它们当作"缺失文件"处理，项目树里对应条目显示为红色，如果所有源文件都漂移了，项目树就只剩一个.pro孤零零地挂着。

修复方法：先右键.pro文件选择显示在文件管理器中，把.pro所在目录和实际源码目录比对一遍。如果源码放在子目录里，比如src/main.cpp和include/mainwindow.h，那就得在.pro里写SOURCES += src/main.cpp、HEADERS += include/mainwindow.h，不能只写文件名。改完保存，右键工程名执行Run qmake，红色条目消失，源文件就全部回来了。

4.2 手写 pro 文件常漏掉的关键变量

有些工程不是 Qt Creator 生成的，是开发者用记事本或者 VS Code 手敲的。手写.pro最常见的毛病是：只写了QT += core gui和TEMPLATE = app，忘了写SOURCES、HEADERS，或者写了但被注释掉了。比如# SOURCES += main.cpp这种，qmake 解析后就当这个变量不存在，项目树自然空荡荡。

要避免这个坑，你只要记住：SOURCES、HEADERS、FORMS、RESOURCES这四个变量决定 Qt Creator 会显示哪些文件。没有它们，Qt Creator 就无从知道你的工程有哪些源码。我建议手写时直接以第六章那份最小模板为底子，改TARGET和文件列表就行，别从零开始敲。

4.3 编码和路径分隔符也容易埋雷

还有一个容易被忽略的问题：.pro文件的编码。如果.pro里带中文注释，而文件保存成了 Windows 记事本默认的 ANSI/GB2312 编码，而不是 UTF-8，Qt Creator 解析时可能把后面的变量内容一起搞乱，表现为文件树加载异常。我建议所有.pro都用 UTF-8 保存，中文注释能省则省。

另外，qmake 对反斜杠\和正斜杠/都认，但手写.pro时用正斜杠更不容易出问题，特别是INCLUDEPATH、DESTDIR、RC_ICONS这类路径变量。反斜杠在字符串里容易被当成转义符，同一个路径换个环境就炸，用正斜杠一劳永逸。

4.4 一条值得背下来的排查链路

看到这里，我把"文件树空白但源码还在"的完整排查链路放出来，你可以复制到备忘录里：

1. 用文件管理器确认物理文件是否齐全；
2. 用文本编辑器打开.pro，检查SOURCES/HEADERS/FORMS是否列出了文件，路径是否真实；
3. 在 Qt Creator 里右键工程名 → 执行Run qmake；
4. 还不行就关闭工程重开，关闭时不要勾选删除.pro.user；
5. 最后再怀疑深目录和 Windows 路径长度问题。

我实测下来，绝大多数"只剩 .pro"的案例都停在第三步就能恢复。真正走到第五步的，基本都是工程目录层级太深导致的，这就是下一章要聊的硬骨头。

5. 深目录地狱：那个 dependent '......' 报错是怎么来的

5.1 报错出现的经典场景

在 Windows 上用 Qt 5.15.2 + MSVC 2019 的时候，如果你的工程位于一个很深的目录里，比如C:\Users\你\Documents\QtCode\2025\test\deep\project\这种，编译时偶尔会出现下面这种错误：

:-1: error: dependent '..\..\..\..\..\..\qt\5.15.2\msvc2019_64\include\qtwidgets/qtwidgetsdepends.h' does not exist.

很多人看到这个第一反应是"Qt 头文件怎么会不存在？是不是 Qt 装坏了？"于是开始重装 Qt。其实这个报错的根源不是安装包，而是 qmake 生成的相对路径太长太深，导致编译器找不到 Qt 安装目录下的头文件。

5.2 qmake 的相对路径计算和 Windows 路径上限

为什么会出现一长串..\..\？qmake 在生成 Makefile 时，默认把 Qt 的 include 目录用相对路径写进INCPATH。工程文件在C:\a\b\c\myproj，Qt 装在C:\Qt\5.15.2\msvc2019_64，qmake 就要把这两者之间的路径差换算成若干个..\回溯。工程离 Qt 安装目录越远，回溯层数越多。Windows 经典路径上限是 260 个字符，一旦回溯前缀加上完整路径超过这个长度，编译器就找不到文件了。

我举个例子方便你理解：你站在一栋大楼的顶层，让你描述停车场里那辆车的具体位置，如果隔了太多楼梯和走廊，路线描述会变得异常冗长，冗长到地图软件都算不出正确坐标。qmake 生成的相对路径就是那个"冗长描述"。

5.3 把工程挪到浅目录的标准操作

处理思路很简单：把工程整体挪到一个浅层级、纯英文、无空格的目录，比如C:\dev\myapp，然后清理旧的构建产物，重新让 qmake 生成。标准操作如下：

1. 关闭 Qt Creator，避免文件占用；
2. 把整个工程目录移动到C:\dev这类浅路径下；
3. 删除工程目录下自动生成的build-工程名-*构建文件夹；
4. 重新打开.pro，确认套件选择正确；
5. 右键工程名 →Run qmake，再Ctrl+B编译。

这里最关键的是第三步。不删旧构建目录的话，Qt Creator 会自动复用里面的旧 Makefile，而旧 Makefile 里的相对路径还是指向原来那个深目录，重新编译照样报同样的错。删掉构建目录让一切从头生成，问题才算真正解决。

5.4 预防和备用方案

如果工程因为某些原因必须留在深目录里，有两个备用方案。一个是在.pro文件里显式给 Qt 的 include 目录写绝对路径，比如INCLUDEPATH += C:/Qt/5.15.2/msvc2019_64/include，让编译器绕开相对路径回溯。另一个是把项目从 qmake 迁移到 CMake，CMake 处理 Qt 依赖时用的是绝对路径推导，很少出现..\..回溯爆掉的问题。

不过这两个方案都有额外成本。绝对路径写死之后换电脑就不通用了，迁移 CMake 也不是一蹴而就的事。所以我的个人建议还是那句老话：工程放在浅目录、纯英文路径下最保险。另外，Windows 10 以上系统可以通过注册表开启长路径支持，但我实测过 qmake 生成的那类依赖判断在部分场景下仍然会报错，所以别对它抱太大期望。

6. 从真·只有 pro，恢复出一个能编译运行的工程

6.1 最小可编译工程模板：pro + main.cpp

如果文件管理器确认目录里真的只有一个.pro，那就只能动手补了。最简单的情况只需要两个文件：一个.pro和一个main.cpp。这是我实测过的最小可编译模板：

myapp.pro：

QT += core CONFIG += console CONFIG -= app_bundle TEMPLATE = app TARGET = myapp SOURCES += \ main.cpp

main.cpp：

#include <QCoreApplication> #include <QDebug> int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); qDebug() << "Hello from myapp"; return a.exec(); }

把这两个文件放到同一个目录，用 Qt Creator 打开.pro，选择套件，直接编译。如果这个最小工程能跑通，说明你的 Qt 环境是好的，问题确实出在工程内容上；如果连这个都编译不过，那才轮到排查 Qt 安装和套件配置。这个验证方式我在排查问题时反复用，省了很多冤枉时间。

6.2 扩展成带窗口的完整工程

如果你的目标是一个带窗口的应用，那要在最小模板基础上加上 widgets 模块，并添加窗口类。常见目录结构如下：

myapp/ myapp.pro main.cpp mainwindow.h mainwindow.cpp mainwindow.ui

对应的.pro里要写：

QT += widgets SOURCES += main.cpp mainwindow.cpp HEADERS += mainwindow.h FORMS += mainwindow.ui

有图标文件的话再加一行RC_ICONS = app.ico；有资源文件就加RESOURCES += resource.qrc；有翻译文件就加TRANSLATIONS += zh_CN.ts。总之每加一类文件就补充对应的.pro变量，一步一动，每次改完都执行一次Run qmake，不要一次堆太多变量再回头排查。

6.3 恢复之后先做一次"干净构建"

从"只剩 .pro"恢复到完整工程后，我建议按这个顺序做一次干净构建，防止旧残留干扰：

1. 删除工程目录下由 Qt Creator 生成的build-*文件夹；
2. 关闭工程，重新打开.pro；
3. 确认"项目"面板里qmake步骤在最上面，Make步骤随后；
4. 先执行清理，再执行构建，最后点运行。

如果编译时出现No rule to make target 'xxx.o'，多半是因为你改了源文件名或移动了目录，而旧 Makefile 还在引用旧路径。重复第一步彻底清理，再重新构建，就能恢复。

6.4 让这个坑以后不再出现的一点点习惯

最后分享一下我自己在建工程时坚持的习惯：所有 Qt 工程都放在一个固定根目录下，比如D:\QtProjects，每个工程直接建在根目录下一层，不再继续嵌套子目录。这样既避免深目录报错，也减少路径漂移。工程建好之后立刻用 Git 做版本管理，.pro.user不进版本库，但.pro、源码、资源都必须提交。真遇到"只剩 .pro"的情况，一条git checkout命令就能把文件全部找回来，比手动重建踏实得多。

其实这些坑绕来绕去，最后都会落到一个道理上：Qt Creator 只是帮你把.pro里声明的东西可视化，它本身不创造内容。你理解了.pro就是工程的唯一真相，左侧树显示什么只是它的投影，也就不会再被"只有一个 .pro"虚惊一场了。下次再遇到，别急着重装，先看一下自己的工程文件里到底写了什么，问题往往一眼就清楚了。