根本原因是qt creator未正确配置构建套件（kit），导致qmake无法执行；常见表现包括kit下拉框为空或标红、构建目录不可编辑、控制台提示“needs a tool chain”，需检查编译器安装、kit关联及路径全英文无特殊字符。
为什么新建项目后点运行就报错“Error while building/deploying project”？
根本原因是 Qt Creator 没配好构建套件（Kit），不是代码问题。它连 qmake 都没找到，更别说编译了。
常见现象包括：项目显示“未配置”，左侧“项目”面板里 Kit 下拉框为空或标红，构建目录灰掉不可编辑，控制台输出类似 Qt Creator needs a tool chain set up to build。
- 检查是否装了配套编译器：Windows 用 MinGW 或 MSVC，Linux 用
gcc、g++，macOS 用 Xcode Command Line Tools —— 运行gcc --version或cl看能不能打出版本号 - 打开 工具 → 选项 → 构建与运行 → Kits，确认列表里有带绿色对勾的 Kit；没有就点“添加”，手动关联已安装的 Qt 版本、编译器、调试器
- 确保 Qt 安装时勾选了对应编译器组件（比如装 Qt 5.15 时没选 MinGW 73，那就算装了 Qt Creator 也找不到可用 Kit）
构建目录提示“Cannot create build directory”怎么办？
这不是权限问题，而是 Qt Creator 默认生成的路径里含非法字符或层级冲突，尤其在中文系统下容易触发。
典型错误日志：Cannot create build directory: .../build-MyApp-Desktop_Qt_5_15_2_MinGW_64bit-Debug，但实际该路径父目录不存在或名字被占用。
- 删掉项目根目录下的
.pro.user文件（它是本地配置缓存，损坏就失效） - 进 工具 → 选项 → 构建与运行 → 通用，点击
Default build directory右侧的 Reset 按钮，重置为默认模板 - 回到项目界面，在“项目”模式下，手动修改
Build directory路径，改成一个绝对、简短、纯英文的路径，例如D:/build/MyApp-debug
打开别人给的工程，提示“No valid settings file could be found”
这是 .pro.user 文件和当前 Qt Creator 版本不兼容，不是项目本身坏了。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
旧版 Creator 生成的配置文件，新版读不了；或者路径里有中文/空格，导致文件加载失败。
- 直接删掉项目目录下的
xxx.pro.user（注意不是xxx.pro） - 把整个项目文件夹移到纯英文路径下，比如从
C:\用户\张三\project改成D:\qt-projects\myapp - 用 Qt Creator 的 File → Open File or Project，精准选中
.pro文件打开，别双击.cpp—— 否则它会当成单个源文件新建空项目，必然找不到.pro
路径含中文或空格，为什么死活编译不过？
Qt 工具链底层调用的是 shell 命令和 Makefile，遇到空格或 UTF-8 路径时，qmake 和 mingw32-make 很容易解析错，尤其在 Windows 上。
错误表现五花八门：Cannot find file xxx.pro、make: *** No targets. Stop.、甚至一闪而过的黑窗报错后直接退出。
- 最稳妥的做法：所有路径全用英文，不用空格，不用中文，不用符号（如
&、(、~） - 如果已踩坑，不要改注册表或加引号绕过 ——
qmake不吃那一套；直接剪切整个项目文件夹，粘贴到D:/qt/这类干净路径下，再重新打开.pro - Git 克隆项目时，也建议先
cd D:/qt再git clone，避免默认落到用户目录引发连锁问题
真正卡住人的，往往不是语法或逻辑，而是路径里一个中文字符、.pro.user 文件多留了一秒、Kit 列表里少了一个对勾 —— 这些地方不报具体错误，只甩一句“构建失败”，得知道去哪盯。
