Termbox 初始化失败主因是终端环境不兼容，需在真实TTY中运行；蛇身移动应预分配切片容量防内存泄漏；PollEvent须非阻塞轮询；每帧必须严格配对Clear()与Flush()。
Termbox 初始化失败：termbox.Init() panic 是路径或终端环境问题
绝大多数人在第一次跑 Termbox 示例时卡在这步，错误通常是 panic: failed to initialize termbox: ...。这不是代码写错了，而是 Termbox 依赖真实的 TTY 环境——它不支持 Windows CMD（旧版）、Git Bash、IDE 内置终端（如 GoLand 的 Terminal），也不支持通过 go run main.go | cat 这类管道运行。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- macOS / Linux：直接在系统 Terminal（iTerm2、GNOME Terminal）中运行
go run main.go - Windows：必须用 Windows Terminal 或 ConEmu，且要确保启用了「启用 VT 处理」（默认 Win10+ 已开；若仍失败，可临时加
os.Setenv("TERM", "xterm")前调用termbox.Init()） - CI/容器环境：Termbox 无法工作，别试 —— 它不是为 headless 场景设计的
蛇身移动逻辑里用 append() 扩容切片导致内存泄漏
常见写法是每次移动都 snake = append(snake, newHead)，再删掉尾巴 —— 看似合理，但 Go 切片底层共用底层数组，频繁 append 可能触发多次扩容，旧数组又没被及时 GC，尤其在高速刷新（如 15 FPS）下，几秒后内存就涨得明显。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 预分配固定容量：用
make([]cell, 0, 200)创建带 cap 的切片，后续移动只做snake = append(snake[:len(snake)-1], newHead) - 避免反复创建新切片：不要写
snake = append(snake[1:], newHead)，这会复制全部剩余元素 - 如果蛇长可能超 200，改用环形缓冲区（
container/ring或自定义 index mod len）比依赖append更稳
键盘输入阻塞主线程：别在 termbox.PollEvent() 里死等
termbox.PollEvent() 默认是阻塞调用，游戏主循环一旦卡在这里，帧率就崩了 —— 比如你设了 60ms 延迟，但用户没按键，那这一帧就卡满 60ms，实际变成 16 FPS 都不到。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
termbox.SetInputMode(termbox.InputEsc)启用 Escape 序列解析（支持方向键） - 把
termbox.PollEvent()放进非阻塞轮询：先select+time.After控制帧间隔，再尝试读一次事件，没读到就跳过 - 别用
for range termbox.EventChannel()—— Termbox 的 channel 模式已废弃，且容易漏事件
绘制闪烁或残影：必须严格配对 termbox.Clear() 和 termbox.Flush()
有人只在蛇移动后重绘蛇身，忘了清屏；有人每帧都 Clear() 但漏了 Flush()；还有人把 Flush() 放在循环外 —— 结果要么满屏乱码，要么画面冻住，要么旧位置残留像素点。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 每一帧开头调用
termbox.Clear(termbox.ColorDefault, termbox.ColorDefault) - 所有
termbox.SetCell(x, y, ch, fg, bg)必须在Clear()之后、Flush()之前 -
termbox.Flush()是强制刷出缓冲区的唯一方式，必须每帧调用一次，且仅一次 - 调试时可在
Flush()后加time.Sleep(10 * time.Millisecond)观察帧节奏，上线前删掉
Termbox 本身没有动画抽象、没有坐标系变换、也不处理鼠标 —— 它只是把终端当画布用。所有“游戏感”都靠你控制帧率、输入采样时机和绘制顺序。最容易被忽略的，是 Clear/Flush 的调用位置和频率，错一次，整个节奏就垮了。
