关键在于Model必须是值类型、Update不可阻塞、View须防panic：Model用struct直传字段，Update返回新实例并用Cmd异步处理IO，View访问前严格校验空指针和切片边界。
用 Bubble Tea 写出能响应按键、不卡死、跨平台可运行的终端 UI，关键不在“怎么画界面”，而在模型定义是否值类型、Update 是否阻塞、View 是否防 panic——错一个，程序就黑屏或失灵。
Model 必须是值类型，否则状态更新完全失效
Bubble Tea 依赖 Go 的值语义做不可变更新：每次 Update 返回新实例，框架用它替换旧模型。若你把 Model 定义成指针（比如 *model），Update 返回的仍是同一地址，View 拿不到变化，界面卡住、按键无反应。
- ✅ 正确写法：
type model struct { count int; items []string }，所有字段直传；Update返回model新值 - ❌ 错误写法：
type model struct { data *someStruct }，除非显式深拷贝整个结构体，否则内部修改不会触发重绘 - ⚠️ 切片要特别小心：Go 中切片是 header（含 ptr/len/cap），直接赋值仍共享底层数组；需用
append([]string{}, m.items...)做浅拷贝，深拷贝则需循环 copy
Update 函数必须秒级返回，HTTP 请求得走 Cmd
终端 UI 是单 goroutine 事件循环，Update 一旦阻塞（比如调 http.Get 或 time.Sleep），整个界面冻结，键盘鼠标全失灵——这不是 bug，是架构硬约束。
- ✅ 正确做法：把 IO 操作封装成
tea.Cmd，例如func fetch(url string) tea.Cmd，内部启 goroutine，完成后发statusMsg或errMsg - ✅ 在
Update中收到tea.KeyPressMsg后，只返回该Cmd，绝不执行同步 IO - ⚠️ 常见坑：忘记用
tea.Sequentially组合多个异步操作；或在Cmd闭包里捕获了旧Model引用，导致状态错乱
View 渲染必须防 panic，空指针和越界访问会直接退出
View() 被每帧高频调用，任何未判空、未校验索引的操作都会立刻 panic，而 Bubble Tea 默认不 recover，终端直接闪退，也不打印堆栈。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- ✅ 每次访问切片前加
if len(m.items) > m.cursor；每次解引用指针前加if m.data != nil - ✅ 用
lipgloss样式时，避免对空字符串调.Width()或.Render()，它内部可能 panic - ⚠️ 特别危险点：
bubbles/list的SetItems若传入nil，后续渲染必崩；务必初始化为[]string{}，而非nil
跨平台构建 Windows 二进制必须加 .exe 后缀
Go 交叉编译 Windows 时，go build -o app 生成的是无后缀文件，但 Windows 终端默认不识别它为可执行程序——双击没反应，命令行报 'app' is not recognized。
- ✅ 正确命令：
GOOS=windows GOARCH=amd64 go build -o app.exe main.go - ✅ Linux/macOS 可省略后缀，但统一加
.exe更安全，尤其 CI/CD 流水线中避免平台差异 - ⚠️ 构建后还要注意编码：Windows 控制台默认 GBK，若输出含中文，建议用
chcp 65001切 UTF-8，或在程序里用golang.org/x/sys/windows显式设置控制台代码页
最易被忽略的是 View 里的边界检查和 Model 的值语义——它们不出现在文档首页，却决定你的程序是稳定运行还是随机崩溃。
