Bubble Tea要求Model为值类型以确保状态更新生效，Update须秒级返回且不可阻塞，View需防panic，跨平台构建Windows需加.exe后缀并注意编码。Model 必须是值类型，否则状态更新会失效Bubble Tea 的 Update 函数返回新模型实例，底层依赖 Go 的值语义做不可变更新。如果你把 Model 定义成指针（比如 *model），Update 返回的仍是同一内存地址，View 渲染时拿不到变化------界面卡死、按键无响应就是最常见现象。? 正确写法：type model struct { count int }，所有字段直传，Update 返回 model 新值? 错误写法：type model struct { data *someStruct }，除非你显式复制整个结构体，否则 data 内部修改不会触发 View 重绘?? 特别注意切片：Go 中切片本身是 header（含 ptr/len/cap），直接赋值仍共享底层数组。如需深拷贝列表状态，用 append(\[\]string{}, m.items...)Update 里不能阻塞，HTTP 请求必须转成 Cmd终端 UI 是单 goroutine 事件循环，Update 必须秒级返回。如果在里面直接调用 http.Get 或 time.Sleep，整个界面会冻结，键盘鼠标全失灵------这不是 Bug，是架构约束。? 正确路径：定义一个命令函数，比如 func fetchURL(url string) tea.Cmd，内部启动 goroutine 并发执行，完成后发 statusMsg 或 errMsg? 在 Update 中收到 tea.KeyPressMsg 后，返回该 Cmd；不要在 Update 里执行 IO?? 常见坑：忘记用 tea.Sequentially 组合多个异步操作，或错误地在 Cmd 闭包里捕获了旧 Model 引用导致状态错乱View 渲染要防 panic，空指针和越界访问最常触发崩溃View() 函数被高频调用（每帧都执行），任何未判空、未校验索引的操作都会立刻 panic，终端直接退出。而 Bubble Tea 默认不捕获 panic，也不会打印堆栈------用户只看到黑屏或闪退。 文心快码 文心快码（Comate）是百度推出的一款AI辅助编程工具