1. 环境准备：理清思路，选对工具
如果你刚接触Qt，想在Windows 10上把它装好，第一步不是急着下载，而是先想清楚几个问题。这就像装修房子，你得先知道要装成什么风格，需要哪些材料，预算多少。我见过不少新手，上来就下载一个最大的安装包，结果C盘瞬间飘红，或者装了一堆用不上的组件，白白浪费时间和空间。
首先，你得知道Qt是什么。简单来说，它是一个非常强大的C++图形用户界面（GUI）开发框架。用它能开发出像QQ、WPS那样带窗口、按钮、菜单的桌面软件，也能做嵌入式设备的界面，甚至还能做手机App。对于Windows 10上的开发者，Qt提供了一个稳定、高效的环境，尤其是它的信号与槽机制，让处理用户交互变得特别直观。
那么，安装前你需要做哪些准备呢？第一，检查你的Windows 10系统。最好是64位版本，因为现在绝大多数开发环境和库都优先支持64位。你可以右键点击“此电脑”，选择“属性”，在“系统类型”那里就能看到。第二，确保你有足够的硬盘空间。Qt本身加上编译器、调试工具，轻松就能占用20GB以上的空间。如果你的C盘（系统盘）空间比较紧张，比如只剩下30-40GB，那我强烈建议你把它安装到其他盘符，比如D盘或E盘。第三，想好你要用哪种安装方式。Qt主要提供两种：离线安装和在线安装。离线安装就是下载一个巨大的、包含所有组件的安装包，一次性搞定，适合网络不稳定或者需要反复安装的环境。在线安装则是一个小巧的安装器，运行时再根据需要下载组件，更灵活，也能获取到最新的版本。
最后，你需要一个Qt账号。无论是哪种安装方式，在安装过程中都会要求你登录。别担心，注册是免费的，去Qt官网花一分钟就能搞定。这个账号主要是用于管理许可证（对于开源开发是免费的）和访问一些在线资源。把这些前期工作想明白了，我们再动手，就能避免很多“踩坑”的麻烦。
2. 离线安装详解：一步到位，稳字当头
离线安装是我个人比较推荐给新手的入门方式，尤其适合国内网络环境可能不太稳定的情况。它的核心思想就是“一劳永逸”——下载一个完整的安装包，断网也能装，装完就拥有一个完整的开发环境，特别踏实。
2.1 获取离线安装包
首先，我们去哪里找这个离线安装包呢？最权威的来源当然是Qt的官方下载页面。但是这里有个关键信息：从Qt 5.15版本开始，官方更倾向于推广在线安装器，对于较新的版本（如5.15.2及以后），可能不再提供独立的离线安装包。不过，对于经典的、非常稳定的Qt 5.14.2或Qt 5.12.12这些LTS（长期支持）版本，你依然可以在官方存档站点或一些可靠的镜像站找到对应的离线安装包。例如，一个典型的离线安装包文件名可能像qt-opensource-windows-x86-5.14.2.exe这样，体积通常在2GB到4GB之间。我建议新手可以从Qt 5.14.2这个LTS版本开始，它非常成熟，社区资料丰富，踩坑的概率也小。
下载完成后，双击这个.exe文件启动安装程序。第一步就是登录，输入你之前注册好的Qt账号和密码。如果没注册，安装界面通常也会有“注册”的链接，点击跳转到官网注册即可。登录成功后，安装程序会展示许可协议，这里勾选同意，然后点击下一步。
2.2 选择安装路径与组件
接下来是最关键的一步：选择安装位置。安装程序默认的路径是C:\Qt。就像我开头说的，如果你的C盘空间充裕（比如剩余空间超过50GB），放在这里没问题，管理起来也方便。但大多数人的C盘是“寸土寸金”，这时候一定要点“浏览”，把它改到其他盘符。我自己的习惯是在D盘或E盘新建一个Develop文件夹，然后把所有开发工具，包括Qt、Visual Studio都放在里面，比如D:\Develop\Qt。这样不仅解放了C盘，也便于后期管理和备份。
选择好路径后，点击下一步，就来到了组件选择界面。这里是离线安装的核心，也是容易让人眼花缭乱的地方。你会看到一个树状结构的列表，里面有很多可勾选的条目。别慌，我们只需要关注最核心的几项。首先，找到Qt->Qt 5.14.2（以你下载的版本为准）这个主节点。展开它，你会看到一堆编译器套件，例如：
- MinGW 7.3.0 64-bit： 这是Qt自带的GCC编译器套件，开源免费，配置简单，适合纯Qt开发。
- MSVC 2017 64-bit和MSVC 2019 64-bit： 这些是微软Visual Studio的编译器。如果你想和Visual Studio集成开发，或者项目里需要用到一些仅MSVC支持的库，就必须勾选这个。
对于Windows 10上的新手，我的建议是：至少勾选一个MinGW版本和一个MSVC版本。比如，勾选MinGW 7.3.0 64-bit和MSVC 2017 64-bit。这样你就拥有了两套编译环境，可以应对大多数情况。至于MSVC 2019，如果你的电脑上已经安装了Visual Studio 2019或2022，那么勾选它会更匹配。
在组件列表里，你还会看到Qt Charts、Qt Data Visualization、Qt Virtual Keyboard等。这些都是额外的功能模块，初期学习完全可以不装，等用到的时候再通过维护工具添加也来得及。为了节省空间，可以先不勾选。最后，确保Qt Creator这个选项是勾选的，它是Qt官方的集成开发环境（IDE），对新手极其友好，我们写代码、设计界面、调试运行都靠它。
2.3 执行安装与验证
选择好组件后，点击下一步，安装程序会给你一个安装摘要，确认无误后，点击“安装”，就可以去泡杯茶了。这个过程根据你选择的组件数量和电脑性能，可能需要30分钟到1个多小时。进度条走完后，点击完成，桌面上通常会出现Qt Creator的快捷方式。
安装完一定要验证。首先，双击打开Qt Creator。第一次启动可能会让你设置Kit（编译套件），如果它自动检测到了你安装的MinGW和MSVC，那就太好了。你可以创建一个简单的测试项目：点击“文件”->“新建文件或项目”->“Application”->“Qt Widgets Application”，然后一路下一步，在“Kit Selection”那里，你可以看到可用的套件，把MinGW和MSVC的都勾选上。最后点击运行（那个绿色的三角箭头）。如果程序能成功编译并弹出一个空白的窗口，恭喜你，离线安装大功告成！这个环境是自包含的，即使断网，你也完全可以进行开发和编译。
3. 在线安装指南：灵活轻量，获取最新
在线安装是Qt目前主推的方式，它的安装器非常小（只有几十MB），运行后再从服务器下载你选择的组件。这种方式最大的优点是灵活和能获取最新版本。你可以轻松安装多个Qt版本，或者为同一个版本添加、删除不同的编译器组件，管理起来非常方便。
3.1 下载与运行在线安装器
你需要访问Qt官网的下载页面，找到“Download the Qt Online Installer”链接，下载这个在线安装器，文件名通常类似qt-unified-windows-x86-4.x.x-online.exe。运行它，同样需要登录你的Qt账号。登录后，你会看到一个欢迎界面，点击“下一步”进入安装文件夹选择。这里我再次强调：不要安装在C盘默认路径！点击“浏览”，选择一个空间充足的盘符，例如D:\Qt。这个路径将是在线安装器管理和存放所有后续下载的Qt版本和组件的地方。
接下来是选择组件的界面，这是在线安装的核心步骤。界面和离线安装类似，但结构更清晰。首先，在“Qt”大类下，你会看到一系列可用的Qt版本，从最新的6.x到经典的5.15.x、5.14.x等。对于新手，如果你想用较新的Qt5，Qt 5.15.2是一个很好的选择，它是Qt5最后一个功能完整的LTS版本。勾选它。
3.2 关键组件选择策略
展开Qt 5.15.2，你会看到编译器子组件。这里的策略和离线安装类似，但需要更注意一点：在线安装允许你更精细地选择。对于Windows开发，这几个组件至关重要：
- MSVC 2019 64-bit： 这是重中之重。因为Visual Studio 2019/2022是目前Windows上的主流IDE，选择MSVC 2019编译器可以让你未来无缝对接VS进行开发。即使你现在只用Qt Creator，这个编译器也性能优秀。
- MinGW 8.1.0 64-bit： Qt在线安装器通常会提供更新版本的MinGW。勾选它可以作为一个轻量级的备用编译环境。
- Sources： 这个建议勾选。它是Qt的源代码。当你按F1查看某个类的帮助文档时，如果能直接跳转到源代码，对于理解底层机制非常有帮助。虽然会多占用一些磁盘空间（约700MB），但对于学习是值得的。
- Qt Creator： 毫无疑问，必须勾选。在线安装器提供的通常是当时最新的Qt Creator版本。
至于Qt WebEngine、Qt Network Authorization等扩展模块，初期学习完全可以跳过。在线安装的好处就在于，以后你随时可以再次运行这个安装器，它就像一个“应用商店”，可以让你添加或删除组件。选择完毕后，点击“下一步”，安装器会计算需要下载的总大小，确认后就开始下载和安装了。这个过程完全取决于你的网速，下载几个GB的数据需要一些耐心。
3.3 安装后配置与多版本管理
安装完成后，启动Qt Creator。在线安装方式下，Qt Creator可能会自动配置好检测到的编译套件（Kits）。你可以在Qt Creator的“工具”->“选项”->“Kits”中查看。应该能看到一个Desktop Qt 5.15.2 MSVC2019 64-bit的套件，其编译器指向你本地安装的MSVC，调试器也自动配置好了。
在线安装器还有一个强大功能：多版本管理。你以后如果想尝试Qt 6.2，不需要卸载旧版本，只需要再次运行同一个在线安装器，登录后，在“选择组件”页面，额外勾选Qt 6.2.0和对应的编译器（如MSVC 2019 64-bit），然后继续安装即可。这样，你的D:\Qt目录下会并存多个版本。在Qt Creator中创建新项目时，就可以在“Kit Selection”步骤中选择用哪个Qt版本来构建你的程序，非常灵活。这种模式特别适合需要在不同项目中使用不同Qt版本的开发者。
4. 避坑指南与深度配置
安装只是第一步，要想在Windows 10上愉快地使用Qt5进行开发，还有一些常见的“坑”需要避开，并进行一些优化配置。这些都是我多年实战积累的经验，能帮你节省大量排查问题的时间。
4.1 路径与权限问题
第一个大坑就是路径包含中文或空格。无论是Qt的安装路径，还是你未来项目的存放路径，都强烈建议使用全英文、无空格的目录。例如，D:\MyQtProjects是好的，D:\编程项目\Qt 测试就是潜在的“地雷”。一些编译工具链（特别是MinGW）对中文路径的支持很差，可能导致编译失败，而且错误信息往往令人费解。
第二个是系统环境变量。通常，Qt安装程序会自动为你配置必要的环境变量，但有时可能会出问题。如果你在命令行（CMD或PowerShell）中输入qmake -v或cmake --version提示找不到命令，就需要手动配置。右键点击“此电脑”->“属性”->“高级系统设置”->“环境变量”，在“系统变量”或“用户变量”中编辑Path，添加Qt和编译器的bin目录。例如，对于MinGW，路径可能是D:\Qt\5.14.2\mingw73_64\bin；对于MSVC，可能需要添加D:\Qt\Tools\QtCreator\bin以及Visual Studio的VC工具链路径。不过，对于使用Qt Creator的新手，只要在IDE内能正常运行，暂时可以不用理会命令行环境。
4.2 编译器套件（Kit）配置详解
Qt Creator的核心概念是“Kit”（套件）。一个Kit定义了用哪个Qt版本、哪个编译器、哪个调试器来构建项目。安装后，Qt Creator通常会尝试自动检测并配置好Kit，但有时需要手动检查或调整。
打开Qt Creator，进入“工具”->“选项”->“Kits”。你会看到“编译器”、“调试器”、“Qt版本”这几个标签页。首先看“Qt版本”，这里应该自动列出了你安装的Qt路径下的qmake.exe，例如D:\Qt\5.15.2\msvc2019_64\bin\qmake.exe。如果这里为空，你需要手动点击“添加”，然后导航到上述路径选择qmake.exe。
然后看“编译器”。对于MSVC，它应该自动指向了你电脑上Visual Studio安装目录下的cl.exe。对于MinGW，则指向g++.exe。如果编译器显示为“（None）”，你就需要手动添加。点击“添加”->“MinGW”，然后浏览到D:\Qt\Tools\mingw730_64\bin\g++.exe（具体路径根据你的安装版本调整）。
最后在“Kits”标签页，确保有一个可用的套件，它正确关联了刚才配置的Qt版本、编译器和调试器（对于MSVC，调试器通常是自动找到的CDB；对于MinGW，可能需要指定为gdb.exe）。把这个套件设为默认，以后新建项目就会自动使用它。
4.3 项目构建与部署实践
当你成功创建并运行了第一个“Hello World”窗口程序后，可能会想：我怎么把它变成一个独立的、可以发给别人用的.exe文件呢？这里就涉及到发布（Deployment）。
直接用Qt Creator编译生成的可执行文件（在项目构建目录的debug或release文件夹里），是不能直接双击在别的电脑上运行的，因为它依赖一堆Qt的动态链接库（DLL）。你需要将这些DLL复制到和你的.exe相同的目录下。具体需要哪些DLL呢？一个简单的方法是使用Qt自带的命令行工具windeployqt。
首先，将你的构建模式切换到Release（在Qt Creator左下角），然后编译项目。编译成功后，在资源管理器中打开生成的release文件夹，找到你的.exe文件。然后，打开开始菜单，找到“Qt 5.15.2 (MSVC 2019 64-bit)”或类似的文件夹，里面有一个“Qt 5.15.2 (MSVC 2019 64-bit) for Desktop”的命令行快捷方式。点击打开它，这是一个已经配置好Qt环境变量的命令行窗口。
在这个命令行里，使用cd命令切换到你的.exe文件所在的目录。然后执行命令：
windeployqt 你的程序名.exe这个神奇的工具会自动分析你的.exe文件依赖哪些Qt模块，并将所有必需的DLL、插件、翻译文件等，都复制到当前目录。完成后，这个文件夹里的所有东西打包压缩，就可以分发到其他没有安装Qt的Windows 10电脑上运行了。这是Qt开发中非常实用的一步，也是从“学习者”迈向“实践者”的关键。
