从安装到第一次断点

1. 安装

1. 在 Cursor / VS Code 扩展市场搜索 LuaDebug 并安装。
2. 用编辑器打开你的 Lua 脚本目录（不要一上来打开整盘游戏工程，索引会很慢）。
3. 禁用其它同样占用调试器 type=lua 的扩展（例如旧版 LuaIde），避免「添加配置」列表错乱。

2. 注册与登录

1. 打开左侧 LuaDebug 活动栏。
2. 注册邮箱账号，查收验证码完成注册。
3. 登录成功后才能使用语言提示与调试能力。

忘记密码：活动栏「忘记密码」。账号服务默认 luadebug.serverUrl = https://luadebug.walterspace.com。

3. 放入调试文件

调试文件位于扩展安装目录的 luadebug 文件夹。安装或更新插件后请重新拷贝到工程可被加载的位置。

• LuaDebug.lua — 标准 Lua
• LuaDebugjit.lua — LuaJIT（多数 Cocos / Unity 热更环境）
• OpenResty 专用文件 — 见框架对接页

在游戏启动流程里尽早接入，例如：

local breakSocketHandle, debugXpCall = require("LuaDebugjit")("127.0.0.1", 7003)
-- Cocos 需把 breakSocketHandle 挂到调度器，见框架对接

host / port 必须与 launch 一致。真机调试时 host 填电脑局域网 IP，不要用 127.0.0.1。

4. 配置 launch

1. 打开「运行和调试」。
2. 若没有 .vscode/launch.json：点「创建 launch.json」，选 LuaDebug。
3. 若已有：点「添加配置…」，选带 LuaDebug: 前缀的片段。
4. 按工程修改 localRoot、port、exePath / commandLine。

列表里没有 LuaDebug：确认扩展已启用、已登录，并禁用其它 type=lua 的调试扩展后重载窗口。

详情见 调试总览、框架对接。

5. 开始调试

1. 在 Lua 源码行号旁下断点。
2. 先在编辑器启动调试（监听端口）。
3. 再启动游戏 / 客户端，确保执行到 StartDebug。
4. 命中断点后可查看变量、调用栈、单步（F10 / F11 等）。