# Wails 绑定规范

## 1. 概述
Wails 通过 context 绑定 Go 方法供前端调用，无需 HTTP API。

## 2. Go 后端绑定

### 2.1 结构体定义
```go
type App struct {
    ctx context.Context
}

func NewApp() *App {
    return &App{}
}
```

### 2.2 方法绑定
- 导出方法（首字母大写）自动绑定
- 方法参数不超过3个，超过时使用结构体
- 返回错误统一使用 `error` 类型

### 2.3 命名规范
- 查询：`GetXxx()`、`ListXxx()`
- 新增：`CreateXxx()`、`SaveXxx()`
- 更新：`UpdateXxx()`
- 删除：`DeleteXxx()`

## 3. 前端调用

### 3.1 调用方式
```typescript
// 导入绑定的方法
import { GetXxx, SaveXxx } from '@/wailsjs/go/main/App'

// 调用
const data = await GetXxx()
```

### 3.2 错误处理
- 统一使用 try-catch 处理
- 错误信息展示给用户

## 4. 参数规范
- 简单参数直接传递
- 复杂参数使用结构体/对象
- 字段命名使用小驼峰

---

> 文档维护者：JueChen  
> 创建时间：2026-01-07