如何定位Godot场景tscn文件的解析错误位置？

问题背景 #

我在Godot中创建了一个Player场景，根节点为Node2D，包含带精灵表的Sprite2D和AnimationPlayer。精灵表包含5个动作各8个方向的动画精灵，仅通过编辑器创建了每个动作的前方向动画。由于动画仅values中的y坐标变化，我编写程序生成其余动画的sub_resource，修改id、resource_name和values后插入tscn文件，并更新AnimationLibrary。

报错信息 #

打开文件时出现如下错误：

scene/resources/resource_format_text.cpp:592 - res://hero_kitten.tscn:709 - Parse Error: Expected Identifier

错误提示指向未修改的根节点行：[node "name"="HeroKitten" type="Node2D"]

已完成排查 #

• 复制生成的动画样本到其他场景可正常打开
• 所有sub_resource的id保持唯一
• 生成的sub_resource已正确加入AnimationLibrary
• 调整load_steps属性无效
• 仅添加全部42个动画时才会出错

提问 #

如何精确定位错误所在行？

定位方案 #

• 直接检查报错行前后语法：虽然错误提示指向709行，但实际问题大概率在该行之前的代码中。打开tscn文件跳转到709行，重点检查前几行的sub_resource定义，看是否存在引号未闭合、逗号缺失、括号不匹配等语法问题。
• 二分法缩小范围：因为仅全量添加动画时出错，先删除一半生成的动画代码，保存后尝试打开场景。若错误消失，说明问题在删除的代码块中；若仍报错，就在保留的代码中继续二分排查，逐步锁定出错的动画代码段。
• 对比手动生成的动画格式：把编辑器手动创建的动画sub_resource和程序生成的代码做逐行对比，检查是否存在格式差异，比如换行、空格、引号类型（单/双引号）、values数组的书写格式等。
• 验证sub_resource语法细节：确保每个生成的sub_resource严格符合Godot规范：
  • id和resource_name无特殊字符或拼写错误
  • values数组无多余逗号、括号匹配正确
  • AnimationLibrary中引用的id与定义的sub_resource id完全一致
• 用命令行工具验证：打开终端运行godot --check-scene res://hero_kitten.tscn，获取更详细的错误输出，辅助定位具体问题。

内容的提问来源于stack exchange，提问作者Bugfish