u-desk/docs/04-功能迭代/GO-DESK-1.尝试/启动指南.md

Go Desk 启动指南

前置条件

1. Go v1.25.4 已安装
2. Node.js 和 npm 已安装
3. MySQL 数据库 lab_dev 已启动

安装 Wails CLI

go install github.com/wailsapp/wails/v2/cmd/wails@latest

如果 wails 命令找不到：

1. 获取 GOPATH：

   go env GOPATH
   

2. 使用完整路径运行（假设 GOPATH 是 D:\Go\go-workspace）：

   D:\Go\go-workspace\bin\wails.exe dev
   

3. 或添加到 PATH 环境变量（永久解决）：

   • 将 %GOPATH%\bin 添加到系统 PATH
   • 重新打开终端

首次启动步骤

1. 安装 Go 依赖

cd go-desk
go mod tidy

2. 安装前端依赖

cd web
npm install

3. 构建前端（必须）

npm run build

这会生成 frontend/dist 目录，包含前端构建产物。

4. 开发模式运行

# 回到项目根目录
cd ..

# 启动 Wails 开发服务器
wails dev

开发流程

修改前端代码后

cd web
npm run build
cd ..
wails dev

修改后端代码后

直接重启 wails dev 即可。

常见问题

问题1：找不到 frontend/dist 目录

解决：需要先构建前端

cd web
npm run build

问题2：数据库连接失败

检查：

1. 测试服 MySQL 是否可访问（外网IP: 39.99.243.191:3306）
2. 数据库 lab_dev 是否存在
3. 用户名密码是否正确（root/Lake@2019）
4. 网络连接是否正常（可能需要VPN或白名单）

问题3：前端调用后端方法失败

检查：

1. 确保 main.go 中正确设置了 Services: []interface{}{app}
2. 前端调用方式：window.go.main.App.QueryUsers(...)
3. 检查浏览器控制台错误信息

问题4：wails 命令找不到

解决：

• 使用完整路径：%GOPATH%\bin\wails.exe
• 或添加到 PATH 环境变量

构建发布版本

1. 确保前端已构建

cd web
npm run build
cd ..

2. 执行构建

# 构建当前平台（Windows）
wails build

# 或明确指定平台
wails build -platform windows/amd64

3. 构建产物

构建成功后，可执行文件位于123：

build/bin/go-desk.exe

4. 运行打包后的应用

直接双击 build/bin/go-desk.exe 运行，或使用命令行：

build\bin\go-desk.exe

注意事项：

• 打包后的应用是独立的可执行文件，包含所有前端资源
• 首次运行需要确保 MySQL 数据库 lab_dev 可访问
• 数据库连接信息硬编码在代码中（localhost:3306, root/123456）
• 如需分发，确保目标机器有 MySQL 数据库或修改为远程数据库连接