Qt开发环境搭建全攻略(Windows+Linux+macOS)

发布于:2025-07-23 ⋅ 阅读:(19) ⋅ 点赞:(0)

一、为啥选择Qt开发?

各位小伙伴,咱搞开发都想一套代码多平台运行,省得在各个系统间折腾。Qt就帮咱实现了这个愿望,用C++开发,一次编写,Windows、Linux、macOS甚至手机、嵌入式设备都能用,简直是开发界的"全能选手"!而且Qt的界面好看,文档全,社区活跃,遇到问题不愁没人帮忙。

二、Windows系统Qt开发环境搭建

1. 准备工作

首先得有个Qt安装包,大家可以去Qt官方网站下载,地址是https://www.qt.io/download 。下载的时候会让你注册账号,注册一个就行,免费的。

2. 安装Qt

双击下载好的安装包,然后按照提示一步一步来:

  • 选择安装路径,别装在C盘,空间不够用,比如可以装在D盘。
  • 选择组件的时候,如果你是初学者,就选MinGW 64-bit(这是个编译器)和Qt Creator(这是开发工具)。要是你还想开发安卓应用,就再选上Android相关的组件。
  • 等着安装完成就行,安装过程可能有点长,喝杯咖啡等会儿。

3. 配置Qt Creator

安装完成后打开Qt Creator:

  • 打开"工具"→"选项"→"Kits"→"编译器",Qt Creator会自动检测到MinGW编译器,如果没检测到,就手动添加,路径一般是安装目录下的mingw64/bin/g++.exe。
  • 再打开"工具"→"选项"→"Kits"→"Qt版本",添加Qt的安装路径,一般是安装目录下的msvc2019_64/bin/qmake.exe。
  • 最后打开"工具"→"选项"→"Kits"→"Kits",创建一个新的Kit,编译器选刚才添加的MinGW,Qt版本也选刚才添加的。

4. 测试环境

创建一个新的Qt Widgets应用程序,写个"Hello World"测试一下:

#include <QApplication>
#include <QLabel>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QLabel label("Hello World!");
    label.show();
    return a.exec();
}

点击运行按钮,如果能看到一个显示"Hello World!"的窗口,那就说明环境搭建成功啦!

三、Linux系统Qt开发环境搭建

1. Ubuntu/Debian系统

打开终端,输入以下命令安装Qt:

sudo apt-get update
sudo apt-get install qt5-default qttools5-dev-tools

安装完成后,终端输入qmake --version,如果能显示Qt的版本信息,就说明安装成功了。

2. Fedora/CentOS系统

打开终端,输入以下命令安装Qt:

sudo dnf install qt5-qtbase-devel qt5-qttools-devel

同样,终端输入qmake --version测试一下。

3. 安装Qt Creator

Qt Creator是个很好用的开发工具,在终端输入以下命令安装:

sudo apt-get install qtcreator  # Ubuntu/Debian
sudo dnf install qt-creator    # Fedora/CentOS

4. 配置Qt Creator

打开Qt Creator,配置方法和Windows系统类似:

  • 打开"工具"→"选项"→"Kits"→"编译器",添加GCC编译器,路径一般是/usr/bin/g++。
  • 打开"工具"→"选项"→"Kits"→"Qt版本",添加Qt的qmake路径,一般是/usr/bin/qmake。
  • 打开"工具"→"选项"→"Kits"→"Kits",创建新的Kit。

四、macOS系统Qt开发环境搭建

1. 安装Xcode

macOS系统开发Qt需要先安装Xcode,在App Store里搜索Xcode并安装。安装完成后,打开终端,输入以下命令安装Xcode命令行工具:

xcode-select --install

2. 安装Qt

从Qt官方网站下载Qt安装包,双击安装,安装过程和Windows系统类似。

3. 配置Qt Creator

打开Qt Creator:

  • 打开"Qt Creator"→"首选项"→"Kits"→"编译器",Xcode编译器应该已经自动检测到了。
  • 打开"Qt Creator"→"首选项"→"Kits"→"Qt版本",添加Qt的qmake路径,一般是安装目录下的clang_64/bin/qmake。
  • 打开"Qt Creator"→"首选项"→"Kits"→"Kits",创建新的Kit。

4. 测试环境

和Windows系统一样,创建一个"Hello World"程序测试一下。

五、常见问题及解决方法

1. 编译器找不到

检查编译器的路径是否正确,特别是Linux和macOS系统,路径可能和默认的不一样。

2. Qt版本不兼容

确保Qt版本和编译器版本兼容,比如Qt 5.15需要较新的编译器。

3. 中文显示乱码

在代码里添加以下代码:

#include <QTextCodec>

// 在main函数开头添加
QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8"));

六、总结

Qt开发环境搭建其实不难,按照上面的步骤一步一步来,不管是Windows、Linux还是macOS系统,都能顺利搭建好。搭建好环境后,就可以开始愉快地写Qt程序啦!要是遇到问题,多查查资料,或者到Qt社区问问,总能解决的。加油,各位小伙伴!


网站公告

今日签到

点亮在社区的每一天
去签到