Godot 新手起步：用 VS Code 和 Codex 扩展开发 2D 游戏

1
2
3
4

编辑器
→ 编辑器设置
→ 文本编辑器
→ 外部

1

使用外部编辑器

1

where code.cmd

1

C:\Users\你的用户名\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd

1

{project} --goto {file}:{line}:{col}

1
2
3
4
5

编辑器设置
→ 文本编辑器
→ 行为
→ 文件
→ Auto Reload Scripts on External Change

1
2
3
4
5
6
7

my_game/
├─ project.godot
├─ AGENTS.md
├─ scenes/
├─ scripts/
├─ assets/
└─ .vscode/

1
2

cd D:\GodotProjects\my_game
code .

1

.vscode/launch.json

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "运行 Godot 项目",
            "type": "godot",
            "request": "launch",
            "project": "${workspaceFolder}",
            "debugServer": 6006
        }
    ]
}

1

godotTools.editorPath.godot4

1

D:\Programs\Godot\Godot_v4.7-stable_win64.exe

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

# Godot Project Instructions

这是一个 Godot 4.x 项目，使用 GDScript。

## 编码规则

- 只使用 Godot 4.x API。
- 不使用 Godot 3.x 旧语法。
- GDScript 尽量使用静态类型。
- 使用 snake_case 命名变量和函数。
- 使用 PascalCase 命名 class_name。
- 节点引用优先使用 @onready。
- 可配置参数使用 @export。
- 不随意更改现有节点名称。
- 不创建过度复杂的 Manager 架构。
- 每次只实现一个可独立测试的功能。

## 文件职责

- scenes/ 保存 .tscn 场景。
- scripts/ 保存 .gd 脚本。
- assets/ 保存图片、字体和声音。
- ui/ 保存界面场景和界面脚本。

## 场景修改规则

- 修改 .tscn 前先读取并理解现有节点结构。
- 不猜测节点名称和 NodePath。
- 对复杂场景，优先告诉用户在 Godot 编辑器中手动创建节点。
- 除非任务明确要求，否则不要大范围重写 .tscn 文件。

## 验证规则

完成任务后：

1. 检查 GDScript 语法。
2. 检查资源路径和节点路径。
3. 列出修改的文件。
4. 说明在 Godot 中如何测试。
5. 不声称已经运行成功，除非确实执行过验证。

1

git init

1
2
3
4
5

.godot/
.vscode/*.log
*.tmp
export/
build/

1
2

git add .
git commit -m "初始化 Godot 项目"

1

2D 俯视角射击原型

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

my_game/
├─ project.godot
├─ AGENTS.md
├─ scenes/
│  ├─ main.tscn
│  ├─ player.tscn
│  ├─ bullet.tscn
│  └─ enemy.tscn
├─ scripts/
│  ├─ main.gd
│  ├─ player.gd
│  ├─ bullet.gd
│  └─ enemy.gd
├─ ui/
│  └─ hud.tscn
└─ assets/

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

这是一个新建的 Godot 4.x GDScript 项目。

我要制作一个最小的 2D 俯视角射击游戏。

请先不要修改文件。

先完成以下工作：

1. 阅读 project.godot 和当前目录结构。
2. 判断当前项目是否已经配置入口场景。
3. 设计最小可行版本。
4. 把任务拆成每一步都可以单独运行验证的小任务。
5. 明确哪些节点应该由我在 Godot 编辑器里创建。
6. 明确哪些脚本适合由你编写。
7. 只使用 Godot 4.x API。
8. 不要一次生成完整游戏。
9. 不要直接编写复杂的 .tscn 文件。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

现在只实现玩家移动。

场景结构为：

Player：CharacterBody2D
├─ Sprite2D
└─ CollisionShape2D

脚本路径：
scripts/player.gd

要求：

- 使用 Input.get_vector
- 使用 move_and_slide
- 使用静态类型
- 移动速度使用 @export
- 不修改场景节点名称
- 不实现射击、生命值或动画
- 修改后告诉我需要配置哪些 Input Map 动作
- 给出测试步骤

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

在 Godot 中建立节点
        ↓
在 VS Code 中让 Codex 写脚本
        ↓
查看 Git diff
        ↓
按 F5 运行
        ↓
把完整错误交给 Codex
        ↓
要求最小修改
        ↓
运行成功后 Git commit

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

运行时出现以下错误：

粘贴完整错误信息

请先定位根本原因。

要求：
- 检查实际节点结构和 NodePath；
- 只做最小修改；
- 不重构无关代码；
- 不修改已经正常工作的功能；
- 修改后解释错误为什么发生。