vscode-lua-debug

安装

在vscode中按Ctrl+P，输入

ext install lua-debug

模块功能

vscode-lua-debug.exe 代理客户端。在launch模式中，vscode-lua-debug.exe会用debugger.dll创建一个调试器进行调试。在attach模式中，vscode-lua-debug.exe会连接一个远程的调试器(也是由debugger.dll创建的)。无论如何，调试开始后vscode-lua-debug.exe只负责在debugger.dll和vscode之间转发消息。
debugger.dll 调试器的核心模块。你可以在你的程序中加载debugger.dll并创建调试器，这样vscode就可以通过attach模式进行调试。
luacore.dll lua核心模块。如果你的程序定制了lua，你可以替换掉它。

配置launch.json

launch模式，模拟lua.exe的行为来执行你的代码，调试器直接加载lua脚本。优点是兼容性比另一种launch模式高、直接可用不需要自己准备lua的执行环境。 * program，lua.exe执行的入口文件
- cwd，lua.exe的当前目录
- stopOnEntry，开始调试时是否先暂停
- luadll，指定lua dll的路径，如果不填则会加载luacore.dll
- path，用于初始化package.path
- cpath，用于初始化package.cpath
- arg0，lua.exe的命令行参数，用于初始化arg的arg[-n] .. arg[0]
- arg，lua.exe的命令行参数，用于初始化arg的arg[1] .. arg[n]
- console，lua的标准输出的编码，可选择utf8、ansi、none，等于none时不会重定向标准输出到vscode
- sourceMaps，一般不需要，作用同attach模式
launch模式，启动一个进程(比如lua.exe或者其他动态链接了luadll的exe)并调试。如果需要调试的目标和lua.exe的行为不一致，可以采用这个模式。
- runtimeExecutable，进程exe的路径
- runtimeArgs，启动进程的参数
- cwd，进程的当前目录，如果不填则是进程exe所在的目录
- luadll，指定luadll的路径，如果不填会尝试搜索进程exe的导入表，搜索不成功则会加载luacore.dll
- stopOnEntry，开始调试时是否先暂停
- sourceMaps，作用同attach模式
attach模式，调试任意加载了vscode-debug.dll的进程。
- stopOnEntry，开始调试时是否先暂停
- ip，远程调试器的ip
- port，远程调试器的端口
- sourceMaps，远程代码和本地代码的路径映射
如果你只是使用在本机的远程调试器，你还可以不使用vscode-lua-debug.exe，直接使用vscode连接调试器。只需要加上"debugServer"的参数。例如

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "attach",
            "type": "lua",
            "request": "attach",
            "program": "",
            "stopOnEntry": false,
            "cwd": "${workspaceRoot}",
            "debugServer" : 4278
        }
    ]
}

远程调试

让debugger.dll和调试目标使用同一个luadll。你可以从以下的方法中选择一个

调试目标使用的luadll名也是luacore.dll
重新编译debugger.dll，使debugger.dll使用的luadll名和调试目标一致
静态链接debugger.dll到调试目标
通过debugger.dll的导出函数set_luadll指定调试目标使用的luadll的路径（在其他一切api使用之前）

自动识别

如果debugger.dll是通过luadll加载的，debugger.dll可以识别出这种情况，并自己设置luadll的路径。通过*require 'debugger'*来加载，并且是通过lua的默认searcher加载；或者自定义的searcher，但是最后调用dll入门函数是通过luaapi来执行的。

// 可以识别
lua_CFunction f = (lua_CFunction)GetProcAddress(h, "luaopen_debugger");
lua_pushcfunction(L, f);
lua_call(L, 0, 0);

// 不能识别
lua_CFunction f = (lua_CFunction)GetProcAddress(h, "luaopen_debugger");
f(L);

在调试目标中加载debugger.dll。debugger.dll目前支持c++导出类和lua模块两套风格的api。为简单起见，这里只说lua模块的加载方式。

确保debugger.dll在package.cpath的搜索范围内，然后执行以下代码

local dbg = require 'debugger'
dbg.listen('0.0.0.0', 4278)

此时调试器会监听4278端口，配置好你的vscode，然后用attach模式启动，调试就会被激活。

调试器初始化之后，并不会阻止lua的继续执行，如果你希望调试器不会错过任何东西，你应该立刻激活调试，并等待vscode连接上来。例如

local dbg = require 'debugger'
dbg.listen('0.0.0.0', 4278)
dbg.start()

yoshiny/vscode-lua-debug

vscode-lua-debug

安装

模块功能

配置launch.json

远程调试