【Godot】【入门】新手报错 TOP10（每条都给“原因+定位方法+一行修复”）

汇总 Godot 新手最常见的 10 条报错，提供出现原因、如何快速定位、以及一行内的修复方案。遇到错误时先对号入座，少走弯路。

1. Invalid get index ‘X’ (on base: ‘Nil’)

• 原因：变量或节点引用是 null，多见于路径写错或时机过早。
• 定位：查看报错行变量，打印 print(node) 检查是否 null；确认是否在 _ready 前访问。
• 一行修复：确保路径正确并使用 @onready var target = $Path/To/Node。

2. Attempt to call function ‘X’ in base ‘Nil’

• 原因：函数调用目标为 null，和上面类似。
• 定位：检查实例是否创建，PackedScene 是否