这一页会带你完成从“会拖积木”到“用自然语言改代码”的关键一步。

MakeCode Arcade 的特别之处是：积木模式和 JavaScript / TypeScript 模式可以互相切换。你可以先用积木做出游戏骨架，再把代码交给 CodeBuddy，让 AI 帮你解释、改写和调试。

01. 你需要安装什么

推荐准备：

  1. CodeBuddy：用来和 AI 对话、保存提示词、修改代码。
  2. MakeCode Arcade：浏览器打开 arcade.makecode.com。
  3. MakeCode 相关插件：在 CodeBuddy 或 VS Code 插件市场里搜索 MakeCode / MakeCode Arcade / PXT。如果你的环境里暂时没有可用插件，也可以使用本页的“复制代码工作流”完成开发。

插图建议：这里放一张 CodeBuddy 插件市场搜索 MakeCode 的截图。如果不同电脑显示不一样，可以标注“找不到插件也没关系，继续使用复制代码工作流”。

02. 两种开发方式

你可以选择其中一种。

方式 A：复制代码工作流，最稳

适合第一次参加的学生。

  1. 在 MakeCode Arcade 里用 Blocks 做出基础游戏。
  2. 点击顶部的 JavaScript 或 TypeScript。
  3. 复制全部代码。
  4. 粘贴到 CodeBuddy，告诉 AI 你想改什么。
  5. 阅读 AI 的解释。
  6. 把修改后的代码粘回 MakeCode。
  7. 运行模拟器，确认没有报错。
  8. 记录这次修改，写进开发日志。

方式 B：插件工作流，适合进阶

如果你的 CodeBuddy / VS Code 环境可以安装 MakeCode 或 PXT 相关插件，可以尝试：

  1. 新建一个 Arcade 项目文件夹。
  2. 用插件打开或同步 MakeCode Arcade 项目。
  3. 在 CodeBuddy 里直接查看 main.ts。
  4. 用自然语言让 AI 修改 main.ts。
  5. 运行或同步回 MakeCode Arcade 模拟器测试。

不同电脑和插件版本会有差异。如果插件流程卡住，不要在环境配置上浪费太久，切回“方式 A”继续开发。

03. 第一次向 AI 提问

先不要问“帮我做一个完整游戏”。这样很容易得到一个你看不懂、也很难调试的项目。

更好的方式是让 AI 做小改动。

可以复制这个 Prompt：

我正在做一个 MakeCode Arcade 游戏。这是我的 TypeScript 代码：

[粘贴代码]

请你先不要大改。请帮我完成 3 件事：
1. 用小学生也能理解的话解释这段游戏现在是怎么玩的。
2. 找出分数、生命值、敌人生成、胜利条件分别在哪些代码里。
3. 建议 3 个容易添加的小功能，每个功能不要超过 20 行代码。

这一步的目标是理解，不是立刻变复杂。

04. 用自然语言添加第一个功能

选择一个小功能，比如金色苹果。

请在我的 MakeCode Arcade 游戏里增加一个“金色苹果”：

1. 每 10 秒有一次机会生成金色苹果。
2. 金色苹果从屏幕顶部掉下来。
3. 玩家接到金色苹果时加 5 分。
4. 接到后播放一个特别音效。
5. 请给我修改后的完整 TypeScript 代码。
6. 请解释你新增了哪些变量、事件和碰撞逻辑。

请尽量使用 MakeCode Arcade 支持的简单写法，不要使用浏览器或 Node.js 才有的 API。

把 AI 返回的代码粘回 MakeCode 后，先运行 3 次：

  • 能正常开始吗？
  • 金色苹果会出现吗？
  • 接到后分数会增加吗？
  • 游戏还能正常胜利或失败吗？

如果不行，把报错截图或报错文字发给 AI。

05. 让 AI 帮你 Debug

调试时，不要只说“坏了”。要给 AI 具体信息。

推荐 Prompt：

我的 MakeCode Arcade 游戏报错了。

现象：
[例如：模拟器不动 / 角色消失 / 分数不变 / 切回 Blocks 失败]

报错信息：
[粘贴红色报错或截图文字]

我刚才想添加的功能：
[例如：金色苹果每 10 秒出现]

这是当前代码：
[粘贴完整代码]

请你：
1. 判断最可能的原因。
2. 只修改必要的几行。
3. 告诉我应该重点检查哪 2 个地方。

调试成功后，把“问题是什么、怎么修好”写成开发日志。这类日志最容易通过 Review，因为它能证明你真的经历了开发过程。

06. 把游戏变成有主题的作品

很多 Arcade 游戏机制看起来相似：躲避、收集、跳跃、射击。真正让你的作品不一样的是主题和表达。

你可以这样改造：

普通机制 可以变成的主题
接苹果、躲炸弹 情绪管理：接住好心情，避开压力怪
平台跳跃 非遗冒险：穿过皮影戏舞台，收集传统纹样
射击敌人 环保守护：清理海洋垃圾，保护红树林
限时迷宫 校园生活：在上课前找到社团教室
Boss 战 考试压力：拆解大 Boss 的焦虑攻击

让 AI 帮你做主题设计时，可以这样问：

我想把一个躲避收集游戏改成“心理健康”主题。
玩家不是接苹果，而是收集好心情，躲避压力怪。

请帮我设计：
1. 游戏标题。
2. 3 种可收集物。
3. 3 种障碍物。
4. 胜利条件。
5. README 里可以怎么解释这个主题。

不要直接写代码，先帮我设计玩法。

07. 什么代码不要直接用？

如果 AI 给你这些东西，要小心：

  • 很长但你看不懂的代码。
  • 浏览器 API，比如 document、window、fetch。
  • Node.js API，比如 fs、path。
  • 太复杂的异步逻辑，比如 Promise、async/await。
  • MakeCode Arcade 不支持的库。
  • 切回 Blocks 后完全无法显示的复杂结构。

不是说这些永远不能用，而是初学阶段不建议用。Review 面试时，你需要解释核心逻辑。

08. AI 面试会问什么？

通过 Review 推荐后，我们会安排一次简短 AI 面试或真人面谈。你可能会被问到：

  • 你的游戏怎么赢，怎么输？
  • 玩家、敌人、道具分别是什么 Sprite 类型？
  • 哪段代码控制分数？
  • 哪段代码控制生命？
  • AI 帮你改了什么？
  • 如果把敌人速度变快，要改哪里？
  • 如果要把胜利分数从 20 改到 30，要改哪里？

你不需要背代码，但你要能打开 MakeCode，指着代码说出大概意思。

09. 开发日志模板

每次使用 AI 改代码后，建议写一篇日志。

标题：我给游戏增加了金色苹果

今天我想让游戏更有奖励感，所以请 CodeBuddy 帮我增加金色苹果。

AI 先解释了原来的 Food 碰撞逻辑，然后新增了一个每 10 秒生成的金色苹果。第一次粘回 MakeCode 时，金色苹果出现太频繁，我把生成概率调低了。

我学到的是：普通苹果和金色苹果可以都用 Food 类型，但要用变量或图片区分它们。下次我想把金色苹果改成“好心情能量球”，让游戏更像心理健康主题。

这样的日志比“今天写了一点代码”好很多。

10. 下一步

当你已经有 3 篇日志、一个 Share 链接和 README 草稿，就可以去看 提交项目与审核。