脚本调试技巧：快速定位不执行的那一行

陆大王

脚本写好了，玩家点了没反应，既没有报错也没有提示。这种问题最耗时间。这篇讲几个我自己常用的调试技巧，能把定位时间从几小时压到几分钟。

一、先确认脚本有没有被触发

在脚本最开头加一行提示或者日志。如果这行没有输出，说明脚本根本没被执行，问题在触发入口，不在脚本内部。这一步能排除掉一半的可能性，很多人却直接跳过。

二、逐段加输出

确认脚本被触发后，在关键节点加输出，看执行停在哪一步。二分法最快：先在中间加，看有没有输出，再往有问题的半边继续。十几次输出就能定位到具体某一行。

三、条件判断打值

条件不满足是最常见的原因。把条件里的每个变量值都打出来，和预期对比。经常是变量名拼错、变量没赋值、或者比较的类型不对，看一眼实际值就明白了。

四、命令是否被支持

用了当前引擎不支持的指令，脚本会静默失败。查引擎的命令表，确认这条命令存在，并且版本匹配。插件命令还要确认插件已加载。

五、注意全角字符

全角空格、全角括号、中文标点，都会让命令解析失败。把脚本放进能显示不可见字符的编辑器，全角字符一目了然。这是最隐蔽也最常见的一类问题。

六、编码问题

脚本文件编码不对，中文会变乱码，命令也可能解析失败。统一用 ANSI 保存，改完重新加载一次。换编辑器之后一定要验证中文显示正常。

七、缓存与重载

改了脚本没重启，引擎用的还是旧内容。确认修改后重新加载脚本或者重启服务端。有些引擎支持热重载，但热重载不一定覆盖所有内容，重要改动还是重启稳妥。

八、用最小可复现脚本

把出问题的逻辑单独抽出来，写一个最简单的脚本测试。能复现就说明逻辑本身有问题，不能复现说明是上下文干扰。抽离之后问题往往一眼就能看出来。

九、把调试输出清理干净

定位完之后把所有调试输出删掉或者注释掉。留在线上，玩家会看到一堆数字，严重的还会暴露内部逻辑。清理这一步不能省。

十、保留一份能跑的旧版本

调试改坏了脚本时，有一份能正常运行的旧版本能立刻恢复。改之前先复制一份，出问题直接切回去，再慢慢查原因。这个习惯能避免很多通宵救火，成本却几乎为零。

十一、固定一套排查模板

把定位流程写成模板：确认触发、逐段输出、条件打值、检查命令、检查编码。每次出问题照着模板走，不依赖当时的灵感。模板越用越熟，排查速度会明显提升。