Qt开发环境搭建全攻略（Windows+Linux+macOS）

一、为啥选择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社区问问，总能解决的。加油，各位小伙伴！