必须安装 lua-debug 插件并配合 lldebugger 或 mobdebug 调试器才能实现真断点调试；仅装 sumneko.lua 仅支持补全，无法断点；需正确配置 launch.json、路径映射及游戏端调试器注入。
装哪个插件才能真断点调试 Lua 游戏脚本
VSCode 自身不支持 Lua 调试，必须靠插件桥接调试器。核心是 lua-debug（不是 Lua 或 IntelliSense for Lua），它才是唯一能配合 lldebugger 或 mobdebug 实现断点、变量查看、单步执行的调试后端。
常见错误现象：Breakpoint ignored because generated code not found 或点击断点无反应——多半是装了语法高亮插件却没配调试器，或用了过时的 luaide 类插件。
- 只装
sumneko.lua→ 有代码补全和跳转，但完全不能打断点 - 只装
lua-debug→ 插件本身不带调试器，必须额外部署lldebugger（推荐）或mobdebug - 游戏引擎用的是
luajit→lldebugger兼容性更好；纯lua 5.1/5.3可选mobdebug，但需手动 require
怎么让游戏进程和 VSCode 的调试器连上
不是装完插件就自动连——必须在游戏启动时注入调试器，并让 VSCode 主动连接或监听端口。关键在启动方式和配置项对齐。
使用场景：你改完 game_logic.lua，想在 on_player_join 函数第一行下断点，但游戏一跑就跳过。
- 用
lldebugger：把lldebugger.dll（Windows）或lldebugger.so（Linux/macOS）放进游戏可执行文件同目录，启动时加参数-debug或修改启动脚本里require("lldebugger").start() - VSCode 的
launch.json必须设"type": "lua"，且"request": "attach"+"port": 8888（默认）；若游戏用mobdebug，则填"request": "launch"并指定"program"启动入口 - 端口被占？改
lldebugger.start({ port = 9999 })，同时同步改launch.json里的port - 路径映射容易错：
"pathMappings"必须写清楚游戏里看到的路径（如/scripts/main.lua）和你本地 VSCode 打开的路径（如${workspaceFolder}/src/main.lua）
为什么断点标灰、hover 看不到变量值
断点标灰 = VSCode 认为这行代码根本不会被执行到，通常因为路径映射失败、源码未加载、或调试器没真正 attach 成功。
性能影响：启用调试后游戏帧率可能下降 10%~30%，尤其高频回调函数（如每帧执行的 update）；lldebugger 比 mobdebug 更轻量，但要求游戏用 LuaJIT 2.1+。
- 检查
launch.json里"stopOnEntry"是否为true—— 如果设了但游戏没进调试模式，会卡住不动 - hover 看不到变量？确认没在
for循环内部或闭包深层作用域；局部变量名被优化掉（Luajit -O2 下常见），临时加local _ = xxx强制保留 - 游戏热重载脚本后断点失效？需要重新触发
lldebugger.start()或重启调试会话，VSCode 不会自动重连
Windows 下 dll 找不到或初始化失败
lldebugger.dll 不是放对位置就行，还依赖运行时和架构匹配。64 位游戏必须用 64 位 dll，且系统要装 vc_redist.x64.exe（Visual C++ 运行库）。
错误信息：error loading module 'lldebugger' from file '.\lldebugger.dll': %1 is not a valid Win32 application → 架构错配最常见。
- 从 lldebugger releases 下载对应平台的预编译包，别自己用 mingw 编
- dll 放的位置：和游戏主程序（如
game.exe）同一目录，不是 和你的.lua文件一起 - 权限问题：某些游戏加壳或沙盒化，会拦截
LoadLibrary；试试以管理员身份运行 VSCode 和游戏 - 杀毒软件误报？
lldebugger.dll常被标为“可疑行为”，临时禁用或加白名单
最麻烦的其实是路径映射和调试器生命周期管理——游戏 reload 脚本、切场景、甚至只是暂停再继续，都可能让调试连接中断，这时候得看输出面板里 Debug Console 的日志，而不是盲目重启 VSCode。
