AutoGo ScriptEngine Debugger v1.0.0 已发布，项目地址：
https://github.com/ZingYao/autogo_scriptengine_debugger/releases/tag/v1.0.0
当前推荐使用 VSCode 或 JetBrains 插件中的 AutoGo Debugger。插件已经内置调试能力，普通脚本开发不需要手动下载命令行工具。
| 能力 | Lua / GLua | JavaScript Debugger |
|---|---|---|
| 调试启动 | 支持 | 不支持 |
| 断点调试 | 支持 | 不支持 |
| 单步调试 | 支持 | 不支持 |
| 调用栈 | 支持 | 不支持 |
| 变量查看 | 支持 | 不支持 |
| 变量修改 | 依赖运行时能力 | 不支持 |
Debugger 当前只提供 Lua/GLua 代码的 DAP 调试。JavaScript Debugger 完全不支持，不提供调试启动、断点、单步、调用栈或变量面板。
VSCode 插件提供 AutoGo Activity Bar 入口和调试按钮。打开 .lua 或 .glua 文件后，使用 AutoGo 面板中的调试入口即可。
典型流程：
- 打开 AutoGo 项目根目录。
- 确认 AutoGo 插件已识别项目和设备。
- 打开需要调试的
.lua或.glua文件。 - 在行号左侧设置断点。
- 点击 AutoGo 面板中的 Debug 当前文件。
- 调试启动后使用 VSCode 原生调试面板查看变量、调用栈和断点。
JetBrains 插件支持 IDEA、GoLand 等 IntelliJ Platform IDE。打开 .lua 或 .glua 文件后，可通过顶部 AutoGo 菜单、工具栏或运行配置启动调试。
典型流程：
- 打开 AutoGo 项目根目录。
- 在 AutoGo 设置中确认 AG、ADB、Go、GLuac 路径已自动发现或手动配置。
- 打开需要调试的
.lua或.glua文件。 - 在编辑器左侧设置断点。
- 使用 AutoGo Debug 当前文件。
- 调试启动后使用 JetBrains 原生 Debug 工具窗口查看栈帧、变量和日志。
IDE 插件在启动 Lua/GLua 调试时会完成以下工作：
- 解析当前入口文件的静态
require依赖闭包。 - 将入口文件和依赖文件增量同步到移动端远程引擎。
- 启动或复用移动端 AutoGo ScriptEngine 远程引擎。
- 创建 DAP 会话并映射本地源码路径与设备端 release 路径。
- 使用 IDE 原生 Debug UI 执行断点、单步、继续、暂停、变量查看等操作。
动态 require 无法在调试前完全推断。遇到动态依赖时，需要把额外脚本文件加入项目同步配置，或改为静态 require。
当前 Lua/GLua 调试支持：
- 文件行断点。
continue、pause、next、stepIn、stepOut。threads、stackTrace、scopes、variables。- 局部变量、Upvalues 和 Globals 快照。
- 异常事件回传。
- 源码路径映射。
- 多文件
require依赖调试。
边界说明：
- Go 注入方法内部不能按 Lua 行单步，只能停在 Lua 调用前后。
- 使用
gluac -s去除调试信息后的字节码不能做源码级调试。 - JavaScript Debugger 完全不支持；不要把 JS 文件配置为调试入口。
示例代码见：
examples/lua_engine/debugger
IDE 插件已内置 debugger 使用路径。只有在需要核对插件内置 debugger 版本或排查工具自身问题时，才需要查看独立 Release。
Release 下载地址：
https://github.com/ZingYao/autogo_scriptengine_debugger/releases/tag/v1.0.0
v1.0.0 提供的平台包：
| 平台 | 文件 |
|---|---|
| Windows x64 | AutoGoScriptEngineDebugger-Windows.zip |
| macOS Apple Silicon | AutoGoScriptEngineDebugger-macOS-ARM.tar.gz |
| macOS Intel | AutoGoScriptEngineDebugger-macOS-AMD.tar.gz |
macOS 解压后如遇到执行权限问题：
chmod +x AutoGoScriptEngineDebugger*不能。当前 debugger 只支持 Lua/GLua 的 DAP 调试，JavaScript Debugger 完全不支持。
优先检查：
- 当前文件是否为
.lua或.glua。 - 调试启动前入口文件和依赖文件是否已成功同步。
- 断点行是否是可执行 Lua 语句。
- 是否使用了 strip 后的
.gluac字节码。 - 动态
require的文件是否已加入额外同步配置。
文档截图已做脱敏处理。实际 IDE 中会显示你的本地项目路径、设备序列号和运行目录；对外反馈问题时请同样打码这些信息。