Qt Creator加载自定义插件失败，绝大多数源于依赖库缺失或路径错误；应将Qt安装目录bin下所有dll（如Qt6StateMachine.dll）拷至Qt Creator的bin目录，并确保插件置于plugins/designer下、版本与编译器匹配。
Qt Creator加载插件失败，绝大多数情况不是插件代码本身有问题，而是运行时找不到依赖库或路径没对上。直接拷贝dll/so文件到对应目录、设置环境变量这两步就能解决90%的问题。
插件报“找不到指定程序”或“load failed”
这是典型的动态链接库缺失错误，比如提示 Qt6StateMachine.dll 找不到，说明你的自定义控件用了 QT += statemachine，但 Qt Creator 的 bin 目录里没有这个依赖。
- 去你 Qt 安装目录的
bin（如D:\software\Qt\6.8.3\msvc2022_64\bin）里找对应 dll - 复制到 Qt Creator 的
bin目录（如D:\software\Qt\Tools\QtCreator\bin） - 别只拷一个——建议一次性把 Qt 安装目录
bin下所有 dll 全拷过去，省得后续反复折腾 - 重启 Qt Creator，再进 帮助 → 关于插件 看是否识别成功
Linux 下报 qt.qpa.plugin: Could not load the Qt platform plugin “xcb”
这个错误表面是插件加载失败，实际是 Qt Creator 自带的 libqxcb.so 被系统旧版 libxcb 库干扰了，或者缺底层依赖。
Qt Creator 18.0.2
下载
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- 先装系统依赖：
sudo apt install libxcb-xinerama0 libxkbcommon-x11-0 libxcb-util1 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-render-util0 - 再强制指定插件路径：
export QT_QPA_PLATFORM_PLUGIN_PATH=/opt/qtcreator/lib/Qt/plugins/platforms - 更稳妥的做法是写个启动脚本，在里面同时设置
LD_LIBRARY_PATH和QT_PLUGIN_PATH，把 Qt Creator 自带的库优先级提上来
Qt Creator 里看不到自定义控件（Designer 不显示）
控件能编译通过、运行时也正常，但在 Designer 里灰掉或不出现，大概率是插件元信息没写对，或者 Qt 版本/构建套件不匹配。
- 确认你的插件工程用了和 Qt Creator 相同的 Qt 版本和编译器（比如 Qt Creator 是 MSVC2022 构建的，你就不能用 MinGW 编译插件）
- 检查插件类的
Q_PLUGIN_METADATA宏里IID是否为"org.qt-project.Qt.QDesignerCustomWidgetInterface" - 确保插件生成的是
.dll（Windows）或.so（Linux），且文件名符合命名规范（如mywidgetplugin.dll） - 插件必须放在 Qt Creator 的
plugins/designer目录下，不是plugins/platforms
真正麻烦的从来不是插件怎么写，而是 Qt Creator 启动时那一堆隐式依赖和路径查找逻辑。每次换 Qt 版本或重装系统后，最好都重新校验一遍 LD_LIBRARY_PATH 或 PATH 里有没有混入其他 Qt 安装路径——冲突往往就藏在这里。
