ebiten.rungame 会卡住或退出是因为它不返回，必须是 main() 最后一行；图片显示异常需注意设备缩放和错误检查；按键检测要用边沿触发；资源须用 embed.fs 嵌入；update 必须显式返回 error。
为什么 ebiten.RunGame 会卡住或直接退出
因为 Ebiten 要求游戏主循环必须由它自己控制，你不能在 main() 里调用完 ebiten.RunGame 后还写后续逻辑——它不会返回，除非游戏退出。常见错误是把初始化逻辑写在 RunGame 后面，或者误以为它像普通函数一样“执行完就继续”。
- 确保
ebiten.RunGame是main()中最后一行可执行语句 - 所有资源加载、状态初始化必须在
Game.Update第一次调用前完成（推荐放在Game结构体构造时） - 如果程序一闪而退，大概率是
Update方法 panic 了，加log.Fatal包裹或启用调试模式：ebiten.SetRunnableOnUnfocused(true)配合终端日志观察
怎么让图片正确显示而不是全黑或拉伸变形
Ebiten 默认不自动缩放图像，ebiten.DrawImage 的目标坐标是像素单位，但窗口逻辑尺寸和实际像素比（device scale）可能不一致，尤其在 macOS 或高 DPI 屏幕上。
- 用
ebiten.IsFullscreen和ebiten.DeviceScale判断当前缩放比，必要时手动调整绘制坐标 - 加载图片务必检查错误：
img, err := ebiten.NewImageFromImage(src)，err != nil时图像是空的，绘制即黑块 - 避免直接用
image.Rectangle硬编码尺寸；优先用img.Bounds().Dx()/Dy()获取真实宽高 - 窗口大小变化时，Ebiten 不会自动重绘旧帧——你需要监听
ebiten.IsWindowResized并在Update中处理尺寸变更逻辑
按键检测失效或延迟：为什么 ebiten.IsKeyPressed 总是 false
ebiten.IsKeyPressed 是瞬时检测，只在按键被按下那一帧返回 true；它不是“是否按着”，也不是轮询状态缓存。新手常把它当“是否按下”用，结果错过唯一触发时机。
- 想响应一次按键（比如跳一下），必须在
Update中判断：if ebiten.IsKeyPressed(ebiten.KeySpace) { jump() } - 想检测长按，得自己维护状态：用布尔变量记录上次是否按下，对比当前状态做边沿检测
- 注意键名大小写：
ebiten.KeyEscape正确，ebiten.KeyEsc或KeyESC都无效 - WebAssembly 目标下部分按键（如
KeyF11）会被浏览器拦截，无法捕获
打包后图标不显示、音频播不出：资源路径怎么写才跨平台
Ebiten 本身不处理资源打包，os.Open 在 Web 或 iOS 上根本不可用。硬编码 "assets/icon.png" 在本地跑得通，一编译成 wasm 就 open 失败。
- 用 Go 的
embed.FS嵌入资源：//go:embed assets/*+fs.ReadFile("assets/icon.png") - 音频文件同理，但注意：WAV 比 MP3 更可靠，Ebiten 的
audio.NewContext对格式敏感，MP3 需额外解码库（如github.com/hajimehoshi/ebiten/v2/audio/wav） - 嵌入后创建图像要用
ebiten.NewImageFromImage，传入image.Decode解出的image.Image，不能直接传字节切片 - Windows 下路径分隔符用
/即可，Go 的embed和path/filepath都兼容
最易忽略的是：Ebiten 的 Update 必须返回 error，哪怕只是 nil；漏写 return 会导致编译失败，但错误提示极不直观——它会报 missing return at end of function，而不是告诉你该返回什么类型。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
