排障手册

调试代码更新了还是无法调试

1. 更新插件后，从扩展目录 luadebug 重新拷贝最新文件到工程并确认被加载。
2. Unity：确认运行时读的不是旧 AB / 缓存脚本。
3. 确认 StartDebug 未被注释，端口与 launch 一致。

启动调试时检索很久

不要把整个游戏 / 引擎仓库当作工作区打开；用 scriptRoots / ignoreDir 缩小索引。

无法连接到账号服务器 / 登录失败

1. 检查网络与 luadebug.serverUrl（须 HTTPS）。
2. 确认已完成邮箱验证。
3. 更新到最新 LuaDebug 后再试。

装了插件但无法调试

1. 禁用其它 Lua 调试扩展。
2. 自定义 loader 的 chunkname 必须是真实路径。
3. 缺少 LuaSocket 时按框架启用。
4. 真机 host 用电脑局域网 IP。

module 'socket.core' not found

工程未集成或不完整启用 LuaSocket。Cocos 需在引擎侧打开 network / luasocket 相关绑定；Unity 各框架集成方式不同，请查对应框架文档。

堆栈路径对不上 / 乱跳文件

1. 检查 localRoot 是否指向正确脚本根。
2. 同一工作区多个游戏目录时，见 调试 · 多游戏目录。
3. Unity DoString 的 chunkname 去掉错误后缀或改为真实路径。

macOS LuaTest Permission denied

检查扩展目录权限，或在系统设置中允许相关程序；必要时重装扩展。

插件卡住或起不来

1. 更新编辑器与 LuaDebug。
2. 临时禁用 C# / Unity 调试扩展试一下。
3. 清理本扩展数据后重装。