Ebiten开发2D游戏核心是Update、Draw、Layout三件事：Update以固定60TPS运行逻辑，Draw按显示器刷新率自适应；inpututil.IsKeyJustPressed仅在Update中有效且仅触发一帧；图片须转为RGBA格式并确保导入image/png等解码器。
Ebiten 做 2D 游戏，核心就三件事：写 Update 处理逻辑、写 Draw 绘制画面、实现 Layout 定义分辨率——其他都是围绕这三点展开的补充。
为什么 Update 和 Draw 调用频率不同？
Ebiten 默认以固定 60 TPS（每秒 60 次）调用 Update，确保游戏逻辑时间步长一致；而 Draw 按显示器刷新率（如 60Hz / 144Hz）自适应调用，可能一帧 Update 对应多次 Draw（如 vsync 开启时），也可能跳帧（ebiten.IsDrawingSkipped() 返回 true）。
- 如果你在
Update里做耗时计算（比如遍历几百个子弹做碰撞检测），会直接拖慢逻辑帧率，但不影响渲染帧率——结果就是“卡顿但画面不撕裂” - 如果在
Draw里做大量图像裁剪或重复SubImage，容易触发 GC 或 GPU 同步瓶颈，导致掉帧——现象是“画面卡，但角色移动仍跟手” - 动画播放、输入响应这类逻辑必须放在
Update，因为inpututil.IsKeyJustPressed只在Update周期里有效
inpututil.IsKeyJustPressed 为什么按一次没反应？
这个函数只在按键“从释放变为按下”的那一帧返回 true，之后立刻变 false。它依赖 Ebiten 内部的按键状态快照，且仅在 Update 函数中可用。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 常见错误：把它写在
Draw里——永远返回 false，因为Draw不维护输入状态快照 - 常见错误：没导入
"github.com/hajimehoshi/ebiten/v2/inpututil"，编译报undefined: inpututil - 常见错误：用错键名，比如写
ebiten.KeyX却误写成ebiten.Key_X或"x"字符串——Go 里键名是预定义常量，不是字符串 - 若需长按持续响应（如角色移动），改用
ebiten.IsKeyPressed(ebiten.KeyArrowRight)
加载图片后显示黑块或 panic: "invalid image: unsupported color model"？
Ebiten 要求所有传入 ebiten.NewImageFromImage 的 Go 标准库 image.Image 必须是 RGBA 格式。PNG 解码后可能是 color.NRGBA 或 color.RGBA64，而某些透明 PNG 还带 alpha 预乘，Ebiten 不自动转换。
立即学习“go语言免费学习笔记（深入）”；
- 最稳做法：强制转成
rgba.Image，用image/draw包复制一次：dst := image.NewRGBA(src.Bounds())<br>draw.Draw(dst, dst.Bounds(), src, src.Bounds().Min, draw.Src)
- 检查是否漏了
_ "image/png"或_ "image/jpeg"导入——没有它，image.Decode无法识别格式，返回nil, nil, fmt.Errorf("unknown format") - Mac 上遇到
CGO_ENABLED=0报错（尤其读取资源文件时），运行前加CGO_ENABLED=1 go run main.go - 资源路径错误时不会 panic，而是静默返回空图，表现为“黑块”或“空白”——建议加日志：
if img == nil { log.Fatal("failed to load image") }
真正难的不是画出一个方块或动起来的角色，而是搞清哪些操作必须在 Update 做、哪些必须在主线程做、哪些资源要提前加载不能现场解码——这些边界不摸清，后面加粒子、音效、状态机全会踩坑。
