wails v2 不支持直接 wails init -t react 创建完整 react 项目，必须手动用 vite 初始化（选 javascript）、配置 wails.json 的 distdir 和 devserverurl、等待 window.wailsbridgeready 后调用 go 函数，并显式注册绑定结构体指针。
Wails v2 默认不生成 React 项目，直接 wails init -t react 会失败或结构错乱——必须手动初始化 React 并对接构建流程。
React 项目不能用 wails init 直接创建
Wails CLI 的模板系统对 React 支持有限，v2.9+ 已移除官方 React 模板。强行指定会生成缺失 package.json、无构建脚本、wails.json 路径错配的半成品。
- 正确做法：先用
npm create vite@latest myapp -- --template react（选 JavaScript，非 TypeScript）初始化 - 再执行
wails init -n myapp -t vanilla生成最小 Go 骨架，避免前端依赖污染 - 把 Vite 项目挪进
frontend/目录，确保frontend/src/main.jsx和frontend/vite.config.js存在 - 删掉
frontend/package.json中与 Wails 冲突的 scripts（如"dev": "wails dev"），只保留"build"和"preview"
wails.json 的 distDir 和 devServerURL 必须手动对齐
Vite 默认输出到 dist/，但 Wails 不会自动识别；开发时若不配代理，wails dev 无法热重载。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
frontend:distDir必须设为"frontend/dist"（不能是"dist"或相对路径） -
frontend:devServerURL设为"http://localhost:5173"（Vite 默认端口），否则wails dev会加载空白页 - 在
vite.config.js中加server.host: true和server.proxy: { "/api": { target: "http://localhost:34115", changeOrigin: true } }（Wails dev server 默认端口） - 构建前务必先运行
npm run build，Wails 不会帮你触发这步——wails build只复制distDir下的文件
前端调用 Go 方法前，必须等 window.wailsBridgeReady，不是 wails.ready()
Wails v2 注入桥接脚本的时机变了：wails.ready() 是旧版 API，新版只暴露 window.wailsBridgeReady Promise。
- React 中不能在
useEffect(() => {}, [])里直接写window.backend.App.GetData()，此时window.backend还未挂载 - 正确写法：
useEffect(() => { window.wailsBridgeReady.then(() => { window.backend.App.GetData() }) }, []) - 如果用了
create-react-app，需确认public/index.html中已引入https://unpkg.com/wails@2.9.0/runtime/runtime.js（或本地 copy） - 调用返回值含时间戳、浮点数时，前端应立即
JSON.parse(JSON.stringify(res))深拷贝，否则后续修改会影响 Go 层内部对象
Go 方法导出必须满足绑定规则，Bind 字段漏传指针就静默失效
Wails v2 不再扫描结构体方法，所有可调用函数必须显式注册到 options.Bind，且类型约束极严。
- 结构体字段必须首字母大写 +
json:tag，例如Name string `json:"name"`，否则前端收不到字段 - 方法接收者必须是指针：
func (a *App) GetData() (string, error)，值接收者会被忽略 -
wails.NewApp(&options)中的options.Bind必须传&App{}，传App{}或nil都不会报错，但前端window.backend.App为undefined - 前端调用路径严格按结构体名来：
window.backend.App.GetData()，若结构体叫MyApp，就得写window.backend.MyApp.GetData()
最易被忽略的是构建阶段的顺序依赖：Wails 不管你前端有没有 build，它只认 distDir 目录是否存在且非空。一个空 dist/ 目录会导致打包后白屏，且无任何错误提示。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
