151 lines
2.6 KiB
Markdown
151 lines
2.6 KiB
Markdown
# Go Desk 启动指南
|
||
|
||
## 前置条件
|
||
|
||
1. Go v1.25.4 已安装
|
||
2. Node.js 和 npm 已安装
|
||
3. MySQL 数据库 lab_dev 已启动
|
||
|
||
## 安装 Wails CLI
|
||
|
||
```bash
|
||
go install github.com/wailsapp/wails/v2/cmd/wails@latest
|
||
```
|
||
|
||
**如果 `wails` 命令找不到**：
|
||
|
||
1. 获取 GOPATH：
|
||
```bash
|
||
go env GOPATH
|
||
```
|
||
|
||
2. 使用完整路径运行（假设 GOPATH 是 `D:\Go\go-workspace`）：
|
||
```bash
|
||
D:\Go\go-workspace\bin\wails.exe dev
|
||
```
|
||
|
||
3. 或添加到 PATH 环境变量（永久解决）：
|
||
- 将 `%GOPATH%\bin` 添加到系统 PATH
|
||
- 重新打开终端
|
||
|
||
## 首次启动步骤
|
||
|
||
### 1. 安装 Go 依赖
|
||
|
||
```bash
|
||
cd go-desk
|
||
go mod tidy
|
||
```
|
||
|
||
### 2. 安装前端依赖
|
||
|
||
```bash
|
||
cd web
|
||
npm install
|
||
```
|
||
|
||
### 3. 构建前端（必须）
|
||
|
||
```bash
|
||
npm run build
|
||
```
|
||
|
||
这会生成 `frontend/dist` 目录，包含前端构建产物。
|
||
|
||
### 4. 开发模式运行
|
||
|
||
```bash
|
||
# 回到项目根目录
|
||
cd ..
|
||
|
||
# 启动 Wails 开发服务器
|
||
wails dev
|
||
```
|
||
|
||
## 开发流程
|
||
|
||
### 修改前端代码后
|
||
|
||
```bash
|
||
cd web
|
||
npm run build
|
||
cd ..
|
||
wails dev
|
||
```
|
||
|
||
### 修改后端代码后
|
||
|
||
直接重启 `wails dev` 即可。
|
||
|
||
## 常见问题
|
||
|
||
### 问题1：找不到 frontend/dist 目录
|
||
|
||
**解决**：需要先构建前端
|
||
```bash
|
||
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. 确保前端已构建
|
||
|
||
```bash
|
||
cd web
|
||
npm run build
|
||
cd ..
|
||
```
|
||
|
||
### 2. 执行构建
|
||
|
||
```bash
|
||
# 构建当前平台（Windows）
|
||
wails build
|
||
|
||
# 或明确指定平台
|
||
wails build -platform windows/amd64
|
||
```
|
||
|
||
### 3. 构建产物
|
||
|
||
构建成功后，可执行文件位于123：
|
||
```
|
||
build/bin/go-desk.exe
|
||
```
|
||
|
||
### 4. 运行打包后的应用
|
||
|
||
直接双击 `build/bin/go-desk.exe` 运行，或使用命令行：
|
||
|
||
```bash
|
||
build\bin\go-desk.exe
|
||
```
|
||
|
||
**注意事项**：
|
||
- 打包后的应用是独立的可执行文件，包含所有前端资源
|
||
- 首次运行需要确保 MySQL 数据库 `lab_dev` 可访问
|
||
- 数据库连接信息硬编码在代码中（localhost:3306, root/123456）
|
||
- 如需分发，确保目标机器有 MySQL 数据库或修改为远程数据库连接
|