Qt Creator安装路径必须在安装时手动指定为全英文无空格路径(如D:\Qt\Tools\QtCreator\10.0.2),不可保留默认用户目录或C:\Program Files;安装后改路径不可靠,应卸载重装并导出/导入设置。

Qt Creator 安装路径本身不能在安装过程中“设置默认值”,但你可以**在运行安装程序时主动指定目标目录**——这是唯一可靠的方式。安装后改路径不现实,重装才是正解。
安装时必须手动改安装路径
双击运行 qt-creator-opensource-windows-x86_64-*.exe(或对应版本)后,安装向导会进入“选择安装位置”步骤。此时默认路径通常是 C:\Users\{用户名}\AppData\Local\QtProject\QtCreator 或类似用户目录,**这个路径强烈不建议保留**:
- 路径含空格和特殊字符,某些构建脚本或第三方工具(如 CMake、CI 脚本)可能解析失败
- 位于用户目录下,容易被系统清理或权限限制干扰
- 多用户共用机器时,不同账号看到的路径不一致,协作出问题
你应该点击“浏览…”按钮,改为一个**全英文、无空格、无中文、盘符充足**的路径,例如:
D:\Qt\Tools\QtCreator\10.0.2
注意:10.0.2 是版本号,建议显式带上,方便后续多版本共存管理。
为什么不能装在 C:\Program Files?
Windows 10/11 下,C:\Program Files 默认启用写保护(UAC),Qt Creator 在运行时会尝试写入配置、缓存、插件数据等。常见现象包括:
- 首次启动卡在“正在加载插件”界面
- 修改快捷键、主题、代码风格后重启失效
-
qmake构建时报错:Cannot write to .qmake.cache
这不是 bug,是 Windows 权限机制的正常行为。绕过它需要以管理员身份运行,但不推荐——IDE 不该依赖提权运行。
和 Qt SDK 路径要分开吗?
要。这是最容易混淆也最影响长期维护的一点:
-
Qt Creator是 IDE 工具,只负责编辑、构建、调试调度 -
Qt SDK(含qmake、moc、lib、include)是构建依赖,由你手动添加到 Kits 中
所以推荐物理隔离:
D:\Qt\Tools\QtCreator\10.0.2 ← Qt Creator 自身安装目录<br>D:\Qt\5.14.2\mingw73_64 ← Qt SDK 目录(含 qmake.exe)<br>D:\Qt\6.7.2\msvc2019_64 ← 另一套 Qt SDK
这样切换 Kit 时不会互相污染,升级 Qt Creator 也不用担心误删 SDK。
安装后发现路径不对怎么办?
别折腾注册表或符号链接。直接卸载,再重装一次——这是最快最稳的方式。卸载前可先导出设置:
- 菜单 →
帮助→关于插件→ 点右下角导出设置(生成settings.xml) - 重装后,在相同菜单里选
导入设置
注意:导入设置不会恢复已安装的插件二进制文件,需重新下载启用。真正重要的只是你的键盘映射、编码偏好、常用构建配置这些文本化参数。
真正麻烦的不是路径本身,而是路径一旦嵌入到项目缓存、构建输出、甚至 CI 脚本里,改起来就牵一发而动全身。一开始就选对,比后期补救省十倍力气。


















