QtCreator启动崩溃报“File Error”：保留配置的调试方法

针对你遇到的Qt Creator加载CMake项目就崩溃，但又不想丢失原有配置、会话的问题，我整理了几个实用的调试步骤，帮你精准定位问题根源：

1. 先做好配置备份，留好退路 #

首先一定要先把现有配置完整备份，避免调试过程中误操作丢失重要设置：

cp -r ~/.config/QtProject ~/QtProject_full_backup

这样不管后续怎么测试，随时可以用备份恢复到初始状态。

2. 逐步排查全局配置文件 #

既然删除整个QtProject目录能解决问题，说明是某个子文件/子目录的配置损坏，不用全删，逐个排查就能找到元凶：

• 先把备份的QtProject目录恢复回原位置，确认正常启动还是崩溃。
• 然后逐个移除QtProject下的子目录/文件，每次操作后重启Qt Creator测试：
  • 优先排查和Welcome插件相关的配置：因为你用qtcreator -noload Welcome能正常启动，大概率是Welcome插件的配置出了问题。先把~/.config/QtProject/qtcreator/welcome目录移到别处，再启动Qt Creator，如果能正常打开，那问题就出在这个目录里的某个文件。
  • 如果Welcome目录没问题，再排查CMake相关的全局配置：比如~/.config/QtProject/qtcreator/CMakeSettings.json或者cmake子目录，移除后测试是否还崩溃。
  • 找到出问题的目录后，再进一步逐个恢复里面的文件，每次恢复一个就重启测试，直到找到损坏的那个具体文件，只删除它即可保留其他配置。

3. 捕获详细的调试日志 #

正常启动时的崩溃可能有隐藏的错误输出，用以下命令捕获完整日志：

QT_LOGGING_RULES="*.debug=true" qtcreator > qtcreator_debug.log 2>&1

启动后等程序崩溃，打开qtcreator_debug.log查看最后几条日志，里面会记录崩溃前的模块活动，比如Welcome插件加载最近项目列表时出错，或者CMake配置读取失败，能帮你快速定位问题点。

另外用gdb调试可以看到精确的崩溃调用栈：

gdb qtcreator

在gdb提示符下输入run启动Qt Creator，崩溃后输入bt，就能看到崩溃发生在哪个函数里，对定位深层问题非常有用。

4. 排查项目本地配置 #

如果全局配置没问题，可能是某个特定项目的本地配置损坏：

• 先移除项目目录下的CMakeLists.txt.user文件（这是Qt Creator生成的项目本地配置），然后用Qt Creator重新打开该项目，看是否还崩溃。
• 如果是最近项目列表导致的问题，可以删除~/.config/QtProject/qtcreator/RecentProjects.xml，启动后手动重新导入项目，避免加载损坏的会话配置。

5. 增量恢复配置 #

找到损坏的配置文件后，不要直接全部替换备份，而是增量恢复其他正常的配置文件，比如：

• 假设是Welcome目录里的recentProjects文件损坏，那只删除这个文件，把Welcome目录里的其他配置（比如界面布局、快捷方式设置）从备份里恢复回去，这样既解决了崩溃问题，又保留了大部分个人配置和会话信息。

内容的提问来源于stack exchange，提问作者Marcus