docs: 新增 go-app 避坑表,记录"未注册路由 404"等坑
- 04-architecture 第四节:新增「go-app 注意事项(避坑表)」,收录 Handler 仅为已注册路由返回 app shell(否则 404)、前后端同包需 //go:build 隔离、wasm 由 app.js 引导、web/ 读 app.wasm、Name 不进 title 等坑 - 05-coding-rules 第 5 节:加指引——写 go-app 代码前先扫避坑表,踩到新坑往那补 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -45,6 +45,7 @@
|
||||
|
||||
## 5. Go / go-app 代码规范
|
||||
|
||||
- **写 go-app 代码前先扫** [架构设计](04-architecture.md) 第四节的「go-app 注意事项(避坑表)」;踩到新坑往那里补,别让同一个坑被踩第二次。
|
||||
- 提交前过 `gofmt` 和 `go vet`;构建用 `GOOS=js GOARCH=wasm go build`(前端)/ 普通 `go build`(后端)。
|
||||
- **错误必须处理**:不忽略 `err`、不用 `_` 吞错;正常流程里不 `panic`(初始化致命错误除外)。
|
||||
- 包 / 文件按职责划分,对照 [架构设计](04-architecture.md) 第二节的前后端职责组织(列表 / 播放器 / 字幕同步 / 生词本 / API 封装)。
|
||||
|
||||
Reference in New Issue
Block a user