让 AI 写 Butano / C 代码:从提示词到编译通过

"AI 能不能写 GBA 代码"在 2026 年已经有了答案:能,但前提是你得搭好一条以编译器为裁判的循环。这篇讲可行性现状、工作流,以及最要命的幻觉问题。

可行性:不是设想,是已发生的事

三个公开案例基本说明现状:2026 年 9 月,有人用 GPT-6 Astra 加 AI 像素生成做出 GBA 游戏,提示词和可玩 demo 都公开了;2026 年 10 月,有 AI agent 从写游戏一路到编译出可用于烧录卡的 .gba,并且自动试玩找 bug;creatoreconomy.so 也流传着"Claude Code 20 分钟做复古游戏"的工作流——Claude 分配像素素材、起草代码。结论可以放心下:路线已通,但"编译通过"只是及格线,跑起来对不对还得验证。

工作流:让编译器当裁判

  1. 备好上下文:把 Butano 官方文档、示例代码、你用的引擎版本号放进 AI 的可见范围(本地文档目录或直接粘贴);
  2. 小步生成:一次只要一个模块——一个精灵类、一段输入处理,不要"帮我生成整个游戏";
  3. 立刻编译:用 C 工具链跑一次真实构建;
  4. 错误原样回贴:把编译报错完整贴回给 AI,让它基于事实修改,而不是让它"自己检查一遍";
  5. 循环直到编译通过,然后进模拟器和真机验证运行逻辑,进入 AI 试玩与修复循环。

用版本控制做小步提交,每编译通过一次提交一次;一旦某轮修改把代码改崩,你能立刻回到上一个能编译的版本。

幻觉警告:编造的 API 一本正经

AI 会编造不存在的 API 和寄存器

GBA 寄存器、Butano 内部接口都是低频知识,AI 极易凭空发明函数名和参数,而且语气自信、格式工整,看起来毫无破绽。编译器是真伪试金石:任何 AI 代码必须过真实编译,编不过的直接打回。也要记住编译通过不等于逻辑正确——API 是否真的该这么用,要拿官方示例对照;寄存器层面的对错,靠硬件文档和真机兜底。

提示词技巧

四个直接见效的做法:贴官方示例——把要仿照的示例代码给它,让新代码沿用同一套 API 用法;指明引擎版本——Butano 不同版本 API 有差异,明确版本能显著减少幻觉;小步提交——一次一个模块,错误定位快;要求标注出处——让它说明每个调用的 API 来自哪个示例或文档章节,说不出来源的大概率是编的。参考模板:

你在帮我写 Butano 引擎的 GBA 代码,引擎版本是
<你的版本号>,以我贴给你的官方示例为准。

任务:实现主角精灵的加载与按键移动。
要求:
1. 先列出将调用的 API 清单,标注每个 API 的出处
   (哪个示例文件或文档章节)
2. 再给出完整代码
3. 不要发明文档与示例里没有的函数;不确定的接口
   直接向我提问

代码量焦虑?先看看 GB Studio 路线

如果目标是"做出游戏"而不是"学 C 开发",GB Studio 路线的代码量少得多——事件系统为主,AI 的主要产出是 JSON 事件流而非 C 文件,见 AI + GB Studio。Butano 路线的价值在于更自由的玩法表达,值得为它多付一些盯编译的时间,引擎本身的上手背景见 Butano 引擎上手。

下一步

编译通过只是开始,接着搭 AI 试玩与修复循环;引擎环境与示例结构,读 Butano 引擎上手;工具链安装一步到位,看 C 工具链配置。

↑