QT的用户量太少，遇到问题在网上根本搜不到解决办法，只好自己做下记录。

1、安装问题，国内通过在线安装包安装，很可能会遇到网络问题，这时候可以设置使用国内的源

找到你的在线安装工具所在目录，使用命令行启动即可，如使用阿里云
 

./qtqt-online-installer-linux-x64-4.8.1.run --mirror https://mirrors.aliyun.com/qt

 今天在windows上重装，出现了这个错误：

https://mirrors.tuna.tsinghua.edu.cn/qt/online/qtsdkrepository/all_os/qt/qt6_681_windows_line_endings_src/qt.qt6.681.doc/6.8.1-0-202411221531qt5-documentation.zip：Error transferring https://mirrors.tuna.tsinghua.edu.cn/qt/online/qtsdkrepository/all_os/qt/qt6_681_windows_line_endings_src/qt.qt6.681.doc/6.8.1-0-202411221531qt5-documentation.zip - server replied: Forbidden

具体原因看这里:QT download issue

解决办法，用python 的mitmproxy库搭个临时的代理服务器，用来修改user-agent字段
pip install mitmproxy
mitmproxy -p 80 --mode reverse:mirrors.tuna.tsinghua.edu.cn -H "/~q/User-Agent/QtUnifiedInstaller"
qt-online-xxxxxxxxxx-installer --mirror http://127.0.0.1/qt

就可以顺利安装了

2、刚安装的QT，所有项目都报错： cannot find -lGL

这是因为缺乏openGL的依赖导致，安装后就可以了。

sudo apt install libgl1-mesa-dev

3、今天想要试试QT的android开发，使用内置的sdk 管理器尝试安装android开发环境，结果发现在qt自带的sdk manager包列表为空，后来查资料才知道是java版本太低导致的

4、qt开发安装android程序构建时提示：无法部署到设备

这是因为找不到android手机导致，一般开发时候都是使用android模拟器进行调试的，只需要添加一个即可

5、vscode调试QT项目，启动调试要等好久

前几天然出现的症状，F5启动调试竟然要等2分钟以上，莫名其妙，各种排查问题，

刚开始一位是加载的dll太多，就创建了一个新QT工程，不链接任何额外的dll,结果发现依然是卡成狗，能想到的办法都试了一遍后，忽然想到会不会是因为找不到QT框架的dll造成，于是就用windeploy工具把依赖拷贝到执行程序目录下，再测试几乎是2秒内反应了。记录下，免得还有别人踩坑。

6、QT Designer自带的控件拖拽就能使用，为什么自己写的控件还需要手动进行链接

用自带控件 → 构建模板已自动把 Qt::Widgets 链接好；
写插件 → 你自己就是“第三方库作者”，必须手动声明它依赖的 Qt 运行库（Qt::Widgets + Qt::UiPlugin / Qt::Designer），否则编译器或 Qt Designer 在加载时都会找不到符号。

7、使用Qt5.14添加组件，出现"此操作至少需要一个处于启用状态的有效资料档案库"的错误提示。

     1. 运行 MaintenanceTool.exe → Settings → Repositories
     2. Add › Temporary Repository，粘贴任意一条
  https://mirrors.tuna.tsinghua.edu.cn/qt/online/qtsdkrepository/windows_x86/root/qt/
  或
  https://mirrors.ustc.edu.cn/qtproject/online/qtsdkrepository/windows_x86/root/qt/
     3. 点击 Test，出现 Status: OK 后 OK / Apply
     4. 回到主界面