2026/4/18 5:57:58
网站建设
项目流程
分销平台网站建设,河南专业做网站,怎样做科技小制作视频网站,重新安装wordpress前言
Qt 是一款跨平台的 C 图形用户界面应用程序开发框架#xff0c;凭借丰富的控件库、便捷的跨平台特性和强大的 Qt Creator 集成开发环境#xff0c;成为桌面端、嵌入式端开发的主流选择。本文将从Qt 版本选择、官网下载、分步安装、环境变量配置、编译工具验证到第一个 …前言Qt 是一款跨平台的 C 图形用户界面应用程序开发框架凭借丰富的控件库、便捷的跨平台特性和强大的 Qt Creator 集成开发环境成为桌面端、嵌入式端开发的主流选择。本文将从Qt 版本选择、官网下载、分步安装、环境变量配置、编译工具验证到第一个 Qt 程序运行全程手把手教你完成 Windows 系统下 Qt 的全套配置零基础也能轻松上手一、Qt 版本选择与下载官网正版安全无捆绑1. 版本选择建议Qt 分为Qt 5和Qt 6两大系列兼顾兼容性和稳定性优先推荐新手入门 / 项目兼容Qt 5.15.2LTS 长期支持版兼容大部分第三方库bug 少社区资源丰富尝新 / 新项目开发Qt 6.5.x 及以上最新特性对 C17/20 支持更好适配现代系统编译工具Windows 下优先选择MinGW 8.1.0/11.2.0轻量、免额外配置直接编译运行若需对接 VS 可选择 MSVC 版本需提前安装 Visual Studio。2. 官网下载步骤Qt 官方下载地址Qt 官方下载页开源免费版商业用途需申请授权打开下载页下滑找到Download Qt Online Installer点击对应 Windows 版本64 位选qt-unified-windows-x64-online.exe若未登录 Qt 账号会提示注册 / 登录邮箱即可注册免费登录后才能继续下载必做步骤下载完成后得到在线安装包约 100M在线安装可按需选择组件避免下载完整包占用空间。二、Qt 在线安装分步教程关键组件必选避坑指南在线安装包运行后需全程联网部分步骤可能因网络问题卡顿耐心等待即可核心是选对组件选少了会导致编译失败选多了占用空间。步骤 1运行安装包同意协议双击下载的qt-unified-windows-x64-online.exe若弹出系统安全提示点击允许此应用运行进入安装向导勾选I have read and agree to the terms and conditions点击Next登录已注册的 Qt 账号无账号则点击Create Account快速注册登录后点击Next。步骤 2选择安装路径重要避免中文 / 空格点击Browse选择安装目录核心要求路径中不能有中文、空格、特殊符号例正确D:\Qt\Qt5.15.2错误D:\编程软件\Qt 5.15.2建议单独创建 Qt 文件夹便于后续管理选择后点击Next。步骤 3选择要安装的 Qt 版本与核心组件重中之重这是安装的核心步骤按需勾选切勿全选全选会占用 50G 空间以「Qt 5.15.2 MinGW 8.1.0」为例勾选如下展开Qt 5.15.2必须勾选MinGW 8.1.0 64-bit核心编译工具Qt 程序的编译、运行依赖此组件可选Qt Charts图表控件、Qt Network网络编程、Qt Widgets基础界面控件默认已包含下方Developer and Designer Tools必须勾选MinGW 8.1.0与上方对应编译工具本体Qt Creator 4.14.2Qt 集成开发环境编写、调试、运行程序的核心工具其余组件如 Android、iOS 支持、MSVC 版本若暂时不用一律不勾选减少安装体积和时间确认勾选后点击Next。步骤 4跳过可选组件开始安装后续步骤会显示「Qt Design Studio」「Qt Documentation」等可选组件直接取消勾选文档可在线查看Design Studio 非开发必需点击Next最后确认安装信息点击Install开始在线下载安装根据网络速度耗时 10-30 分钟请勿中断。步骤 5安装完成跳过额外设置安装完成后会提示「Launch Qt Creator」可先勾选点击Finish直接启动 Qt Creator完成安装。三、环境变量配置MinGW 编译工具全局可用配置环境变量的目的是让 Windows 系统能全局识别 Qt 的编译工具g、make无论是在 Qt Creator 还是 cmd/PowerShell 中都能直接编译 Qt 程序核心是配置 MinGW 的 bin 目录。步骤 1找到 MinGW 的 bin 目录路径根据你之前的安装路径找到 MinGW 的 bin 目录标准路径示例对应 Qt 5.15.2 MinGW 8.1.0D:\Qt\Qt5.15.2\5.15.2\mingw81_64\bin若安装的是 Qt 6路径类似D:\Qt\Qt6.5.3\6.5.3\mingw1120_64\bin关键验证进入 bin 目录能看到g.exe、gcc.exe、mingw32-make.exe等文件说明路径正确。步骤 2打开 Windows 环境变量设置右键此电脑→ 选择属性→ 右侧点击高级系统设置→ 弹出「系统属性」窗口点击环境变量或直接在 Windows 搜索框输入「环境变量」选择编辑系统环境变量快速打开。步骤 3配置用户变量推荐仅当前用户生效无权限问题在「环境变量」窗口的用户变量区域上方找到Path变量双击编辑点击新建将第一步找到的 MinGW bin 目录路径完整粘贴进去例D:\Qt\Qt5.15.2\5.15.2\mingw81_64\bin点击上移将该路径移到顶部避免与其他编译工具冲突依次点击确定保存所有打开的窗口都要点击确定否则配置不生效。步骤 4验证环境变量是否配置成功打开新的 cmd 窗口关键必须关闭原有 cmd重新打开否则环境变量不刷新分别输入以下 3 条命令若能正常显示版本信息说明配置成功bash运行gcc -v g -v mingw32-make -v若提示「不是内部或外部命令」说明路径错误或未保存环境变量重新检查步骤。四、Qt Creator 编译器与构建套件验证核心配置避免编译失败安装和环境变量配置完成后需验证 Qt Creator 是否能正确识别编译器和构建套件Kit这是运行 Qt 程序的前提无需手动配置Qt 会自动识别只需验证即可。步骤 1打开 Qt Creator 的设置界面启动 Qt Creator顶部菜单栏选择工具→选项快捷键CtrlAltO在弹出的窗口左侧依次展开构建和运行→ 选择编译器。步骤 2验证编译器MinGW GCC在「编译器」页面右侧应能看到MinGW 8.1.0 64bit (GCC)或对应版本的 MinGW GCC状态为「自动检测」说明 Qt Creator 已识别到编译工具无需额外操作。步骤 3验证构建套件Kit在左侧「构建和运行」下选择套件右侧应能看到Desktop Qt 5.15.2 MinGW 64bit或对应版本的套件且「编译器」「Qt 版本」「调试器」均已正确关联无红色感叹号若套件正常说明 Qt Creator 配置完成可直接用于开发。五、编写第一个 Qt 程序Hello World验证全套配置通过一个简单的「窗口 文字」程序验证 Qt 的编译、运行是否正常全程在 Qt Creator 中操作新手易上手。步骤 1创建新的 Qt 项目打开 Qt Creator欢迎页面点击新建项目或顶部菜单栏文件→新建文件或项目在弹出的窗口中选择Application→Qt Widgets Application→ 点击选择项目命名输入「HelloQt」名称不能有中文 / 空格选择项目保存路径建议单独创建项目文件夹如D:\Qt_Projects\HelloQt点击下一步类信息配置保持默认即可基类选择QMainWindow类名MainWindow勾选「创建界面」点击下一步构建套件选择勾选之前验证的Desktop Qt 5.15.2 MinGW 64bit点击下一步最后点击完成创建项目。步骤 2编写代码添加文字项目创建完成后左侧「项目管理」栏展开HelloQt→源文件→ 双击打开mainwindow.cpp在MainWindow::MainWindow(QWidget *parent)构造函数中添加一行代码头文件已自动包含无需额外添加完整代码如下cpp运行#include mainwindow.h #include ui_mainwindow.h MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) , ui(new Ui::MainWindow) { ui-setupUi(this); // 新增代码设置窗口标题添加Hello World文字 this-setWindowTitle(我的第一个Qt程序); ui-centralWidget-setWindowTitle(Hello Qt! Hello World!); } MainWindow::~MainWindow() { delete ui; }步骤 3编译并运行程序Qt Creator 左下角点击运行按钮绿色三角形快捷键CtrlR或顶部菜单栏构建→运行程序会先编译底部编译栏无红色错误信息再运行若弹出一个标题为「我的第一个 Qt 程序」的窗口说明全套配置成功六、常见问题与避坑指南新手必看解决 90% 的问题问题 1安装时卡顿 / 下载失败原因Qt 官方服务器在国外网络不稳定解决重启安装包选择国内镜像源安装时若有「Select a mirror」选项选择中国镜像或切换网络如手机热点。问题 2编译时提示「找不到 g/make 命令」原因环境变量配置错误或未打开新的 cmd 窗口解决重新检查 MinGW bin 目录路径确保粘贴完整关闭原有 cmd 重新验证或重启电脑让环境变量生效。问题 3Qt Creator 中套件有红色感叹号无法编译原因安装时未勾选对应 MinGW 组件或 Qt 未识别到编译工具解决重新运行 Qt 安装包添加对应的 MinGW 组件或在 Qt Creator 中手动指定编译器路径工具→选项→构建和运行→编译器→添加→MinGW选择对应 bin 目录。问题 4路径中有中文 / 空格导致程序编译 / 运行失败原因Qt 对中文、空格路径支持不佳会出现文件识别错误解决彻底修改路径安装目录、项目目录均改为「英文 数字」无空格、无特殊符号最根本的解决方法。问题 5运行程序时提示「缺少 xxx.dll 文件」原因未将 MinGW 的 bin 目录加入环境变量或程序运行时未加载依赖库解决确认环境变量配置成功重启 Qt Creator或直接将 bin 目录中的相关 dll 文件复制到程序运行目录。七、总结本文完成了 Windows 系统下 Qt 开发环境的全套配置核心步骤可总结为 4 点下载官网在线安装包注册登录后下载优先选择 Qt 5.15.2 LTS 版本安装核心勾选「MinGW 编译工具 Qt Creator 对应 Qt 版本」路径无中文 / 空格配置将 MinGW 的 bin 目录加入系统 Path 环境变量cmd 验证 gcc/g 命令验证Qt Creator 中检查编译器和套件创建第一个 Qt 程序并运行。