必须手动设置QT_DIR指向具体Qt版本路径，如C:\Qt\5.15.2\mingw81_64，并确保qmake -v输出的版本号与QT_VERSION_MAJOR完全匹配；qtdeploy构建失败主因是CGO环境未对齐、平台插件缺失或动态库路径未嵌入。
Go 用 Qt 绑定开发桌面应用，不是“能不能”，而是“怎么避开编译链和环境变量的坑”。therecipe/qt 是目前唯一能跑通全平台（Windows/macOS/Linux）的成熟绑定，但它不自动适配你的 Qt 安装路径、不帮你选编译器、也不容忍 CGO_ENABLED=0 下直接构建 GUI 应用。
为什么 qtsetup 总失败或找不到 qmake
根本原因不是 Go 写错了，而是 qtsetup 启动时只查环境变量 QT_DIR 和 PATH 中的 qmake，且对版本敏感。它不会去扫描 C:\Qt 下所有子目录，也不会读取 Qt MaintenanceTool 的注册信息。
- 必须手动设置
QT_DIR指向具体版本路径，比如C:\Qt\5.15.2\mingw81_64（Windows）或/usr/local/Cellar/qt/5.15.2（macOS Homebrew） -
qmake -v输出的 Qt 版本号必须与QT_VERSION_MAJOR匹配，例如输出5.15.2就得设QT_VERSION_MAJOR=5.15.2，不能只写5.15 - Linux 用户若用系统包管理器安装 Qt（如
apt install qt5-default），qmake常在/usr/lib/x86_64-linux-gnu/qt5/bin/qmake，但默认不在PATH，需显式加进PATH或用QT_DIR指向该目录上级 - macOS 上 Qt Creator 自带的 Qt 不会自动加入
PATH，qtsetup找不到就报exec: "qmake": executable file not found
qtdeploy build desktop 编译失败常见错误
最常卡在 cgo、MSVC 工具链或静态链接上。这不是 Go 代码问题，是构建上下文没对齐。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
undefined reference to 'QApplication::QApplication(int&, char**)：说明链接器没找到 Qt 的 C++ 运行时，大概率是QT_MSVC=true但没运行vcvarsall.bat，或 MinGW 版本与 Qt 不匹配（如 Qt 用 mingw81，你却用了 mingw11） -
cannot find -lQt5Core -lQt5Widgets：qtsetup成功了，但qtdeploy没继承QT_DIR，需在构建命令前重设，例如QT_DIR=/opt/Qt/5.15.2/gcc_64 qtdeploy build desktop main.go - Windows 下生成的 exe 双击闪退：缺少 Qt 平台插件（
platforms/qwindows.dll），qtdeploy默认不打包，得手动用qtdeploy -debug build desktop main.go查看输出路径，再把platforms/目录整个复制到 exe 同级 - macOS 报
dyld: Library not loaded: @rpath/...：Qt 动态库路径没 embed 进二进制，要用install_name_tool修复，或改用qtdeploy build macos main.go（它会自动处理 rpath）
数据模型绑定：别直接实现 QAbstractItemModel
Go 里手写完整 QAbstractItemModel 接口（10+ 方法）极易出错，尤其 index() 和 parent() 的行列/层级逻辑。实际项目中，90% 场景用不到自定义 model。
立即学习“go语言免费学习笔记（深入）”；
- 列表展示优先用
QStandardItemModel：它已封装好内存管理，Go 侧只需调model.AppendRow(...)，不用管QModelIndex构造 - 表格数据用
QSqlTableModel（连数据库）或QStandardItemModel+SetRowCount/SetColumnCount，避免从零实现data()和setData() - 真要响应数据变更，用
model.DataChanged().Connect(...)，而不是轮询或手动beginResetModel()/endResetModel() - QML 场景下，更推荐用
QQmlApplicationEngine加setContextProperty暴露 Go struct，比 model/view 更轻量
最麻烦的从来不是写界面逻辑，而是让第一个窗口在三台机器上都弹出来——QT_DIR 路径、qmake 版本、平台插件位置，这三个点漏一个，qtdeploy 就只给你一个静默失败。
