Tarantool Lua Debugger for Visual Studio Code：简化您的Lua开发调试

Tarantool Lua Debugger是一款专为Visual Studio Code设计的Lua调试工具，无需额外依赖，帮助开发者高效调试Lua代码。最新版本0.3.0带来了一项重要更新，对于使用源码映射调试（如TypescriptToLua转换的代码）的项目，现在必须在启动配置中指定scriptFiles选项，以便在原始源文件中使用断点。这项改进大幅提升了调试性能，使断点在启动时即可解析。

主要功能：

• 通过Tarantool调试Lua代码
• 提供基本调试功能，包括步进、检查、断点等
• 支持条件断点
• 将协程作为独立线程进行调试
• 基本支持源码映射，如TypescriptToLua生成的映射

使用方法：

要使用特定的Tarantool可执行文件调试Lua程序，您可以在用户或工作区设置中设置lua-tarantool.tarantool。或者，您可以在launch.json中设置解释器和要运行的文件：

{
  "configurations": [
    {
      "type": "lua-tarantool",
      "request": "launch",
      "name": "Debug",
      "program": {
        "tarantool": "",
        "file": "${file}"
      }
    }
  ]
}

要求与限制：

• Lua环境必须支持通过stdio或管道进行通信。某些环境可能需要命令行选项来支持stdio通信（例如，Solar2D需要/no-console标志）。如果使用io.read或其他需要用户输入的调用，会在stdio模式下造成问题。可以通过将program.communication设置为pipe来解决此问题。
• Lua环境必须包含调试库构建，且其他代码不应尝试设置调试钩子。
• 在程序运行时无法手动暂停调试。
• 在Lua 5.1和LuaJIT中，当在协程内部停止时，无法访问主线程。

请注意，lldebugger的路径将自动添加到LUA_PATH环境变量中，以便Lua可以找到它。

使用技巧：

• 为了方便，全局引用调试器始终存储为lldebugger。
• 可以通过检查环境变量LOCAL_LUA_DEBUGGER_VSCODE来检测调试器扩展是否已附加。这在自定义环境中条件性启动调试器时非常有用。

if os.getenv("LOCAL_LUA_DEBUGGER_VSCODE") == "1" then
  require("lldebugger").start()
end

• 某些自定义环境不会在未捕获的运行时错误上中断。要捕获运行时错误，可以使用lldebugger.call()包装代码：

lldebugger.call(function()
  --code causing runtime error
end)

• 某些环境不会从标准文件系统加载所需的文件。在这些情况下，您可以使用LOCAL_LUA_DEBUGGER_FILEPATH中存储的文件路径手动加载调试器：

package.loaded["lldebugger"] = assert(loadfile(os.getenv("LOCAL_LUA_DEBUGGER_FILEPATH")))()
require("lldebugger").start()

额外配置选项：

• scriptRoots：用于查找Lua脚本的替代路径列表。这对于使用自定义解析器查找脚本的环境（如LÖVE）非常有用。
• scriptFiles：调试时在工作区中查找Lua脚本的glob模式列表。这对于在源码映射文件中放置断点是必需的（例如，使用TypescriptToLua时的'ts'脚本），因为必须提前查找源文件，以便解析断点。
• ignorePatterns：指定在步进代码时要跳过的文件的Lua模式列表。
• stepUnmappedLines：在步进源码映射代码时，如果当前行没有映射，则步入Lua。
• breakInCoroutines：在协程内部发生错误时中断到调试器。
• stopOnEntry：在设置调试钩子后的第一行自动中断。
• cwd：指定启动可执行文件的工作目录。默认是项目目录。
• args：启动时传递给Lua脚本或自定义环境的参数列表。
• env：指定启动可执行文件时设置的环境变量。
• program.communication：指定扩展程序如何与调试器通信。可选值包括stdio（默认）和pipe。
• verbose：启用调试器的详细输出。仅在尝试识别调试器本身的问题时有用。