讲师中心 微信公众号
AI工具推荐 视频效率加速

Qt Creator下载后怎么完成环境配置?

胖墨同学_8051

胖墨同学_8051

发布时间:2026-08-07 19:13:19

|

679人浏览过

|

来源于php中文网

原创

Qt Creator安装后无法直接编译运行,是因为它依赖外部Qt库和编译器;需在“工具→选项→构建和运行→Kits”中配置Qt版本(qmake路径)与编译器(如MinGW的g++.exe),并确保路径全英文无空格。

qt creator下载后怎么完成环境配置?

Qt Creator 下载安装后不能直接写代码跑起来,是因为它只负责编辑、调试和项目管理,真正编译运行依赖外部的 Qt 库和 编译器。没配好这两样,新建项目点“构建”会报错,比如 No valid kits found 或 Cannot find Qt version。

Kit 红色警告怎么消?

启动 Qt Creator 后,右下角状态栏如果显示红色 Kit(套件)图标,说明它找不到可用的构建环境。这不是软件坏了,是配置没到位。

  • 打开 工具 → 选项 → 构建和运行 → Kits,看列表里 Kit 是否带红色感叹号
  • 点开那个 Kit,检查「Qt 版本」和「编译器」两项是否为空或标红
  • 如果为空,先去「Qt 版本」页添加 Qt 安装路径下的 qmake(Windows 是 qmake.exe,Linux/macOS 是可执行文件),路径类似:C:\Qt\5.15.2\mingw81_64\bin\qmake.exe
  • 再进「编译器」页确认已识别你的编译器:Windows 常见是 MinGW 8.1 对应的 g++.exe,macOS 是 clang,Linux 是 gcc/g++
  • 最后回到「Kits」页,手动为该 Kit 选中刚添加的 Qt 版本和编译器,保存即可

为什么选 MinGW 而不是 MSVC?

Windows 用户容易在这一步卡住——MSVC 编译器需要你本地已安装对应版本的 Visual Studio(比如 Qt 5.15.2 推荐 MSVC 2019),而 MinGW 是 Qt 安装包自带的轻量级方案,不用额外装 VS。

Qt Creator 18.0.2
Qt Creator 18.0.2

Qt Creator 18.0.2 Windows x86_64 历史版本安装包,适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。

下载
  • 如果你没装 Visual Studio,别强行选 MSVC,否则「编译器」页找不到任何条目
  • Qt 在线安装器里勾选 MinGW 64-bit 组件后,g++.exe 默认在 C:\Qt\Tools\mingw81_64\bin\(路径含版本号,注意核对)
  • MinGW 生成的程序不依赖 VC 运行时 DLL,分发更干净;但调试体验略弱于 MSVC(比如断点响应慢一点)
  • Qt 6.5+ 对 MinGW 支持更稳,但某些模块(如 WebEngine)仍需 MSVC,这点得看具体需求

Linux/macOS 上编译器路径怎么填?

Linux 和 macOS 不像 Windows 那样有明确安装目录,g++ 或 clang++ 通常在系统 PATH 里,但 Qt Creator 不自动扫描,得手动指定完整路径。

  • Linux:终端运行 which g++,结果类似 /usr/bin/g++,就填这个;调试器填 /usr/bin/gdb
  • macOS:Xcode 命令行工具装好后,which clang++ 一般返回 /usr/bin/clang++;若用 Homebrew 装的 Qt,qmake 路径可能是 /opt/homebrew/opt/qt/bin/qmake
  • 注意 macOS M 系列芯片用户,Homebrew 默认装在 /opt/homebrew,别错填成旧路径 /usr/local
  • 如果填完仍报错,检查终端里能否直接运行 qmake --version 和 g++ --version,通不过说明环境变量没生效

中文路径或空格会导致什么问题?

这是新手最常踩却最难排查的坑:只要 Qt 安装路径、项目路径或用户名含中文或空格,qmake 解析就会失败,报错可能五花八门,比如 Project ERROR: Cannot run target compiler 'g++' 或直接卡在解析 .pro 文件。

  • 重装 Qt 时,安装路径务必用纯英文,例如 C:\Qt 或 /home/user/Qt,避开 桌面、我的文档、Program Files (x86)
  • 新建项目时,项目路径也必须全英文无空格,HelloWorld 可以,Hello World 或 测试项目 就不行
  • Windows 用户尤其注意:默认安装路径是 C:\Users\用户名\Documents,而用户名是中文的话,整个链路就废了
Kit 配好了不代表万事大吉——第一次构建时,.pro 文件里写的 QT += widgets 如果对应模块没装,依然会报错。这时候得回头检查安装时是否勾选了 Qt Widgets 模块,而不是只装了个最小化 Qt 库。

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

更多
C++ Qt图形开发
C++ Qt图形开发

本专题专注于 C++ Qt框架在图形界面开发中的应用,系统讲解窗口设计、信号与槽机制、界面布局、事件处理、数据库连接与跨平台打包等核心技能,通过多个桌面应用项目实战,帮助学员快速掌握 Qt 框架并独立完成跨平台GUI软件的开发。

4302

2025.08.15

C++桌面程序开发
C++桌面程序开发

本专题聚焦 C++ 在桌面端图形界面应用开发中的实战应用,系统讲解 Qt 框架的信号与槽机制、界面布局管理、事件响应、数据交互、样式美化与多窗口应用设计等核心知识。通过实战案例(如记事本应用、数据管理工具、系统监控面板),帮助学习者掌握 从UI设计到完整桌面软件开发的C++工程化能力。

1234

2025.10.23

C++ 图形界面开发基础(Qt方向)
C++ 图形界面开发基础(Qt方向)

本专题系统讲解 使用 C++ 与 Qt 进行图形界面(GUI)开发的核心技能,内容涵盖 Qt 项目结构、窗口组件、信号与槽机制、事件处理、布局管理、资源管理,以及跨平台编译与打包流程。通过多个小型桌面应用实战案例,帮助学习者掌握从界面设计到功能实现的完整 GUI 开发能力。

1401

2025.12.05

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

0

2026.10.08

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

120

2026.09.30

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

100

2026.09.30

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

80

2026.09.30

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

80

2026.09.30

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

100

2026.09.29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Qt入门课堂 - Qt Quick Controls
Qt入门课堂 - Qt Quick Controls

共0课时 | 0人学习

Qt Creator 调试文档
Qt Creator 调试文档

共0课时 | 0人学习

Qt Creator 项目创建文档
Qt Creator 项目创建文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn