common-functions.md

其他功能说明

多目标调试 (multi-target)

有时我们希望同时调试多个lua虚拟机。最简单的办法是启动多个vscode窗口，打开不同的项目，分别和各虚拟机建立连接，唯一要注意的是不同的虚拟机需要设置不同的端口通信（ 同时修改launch.json和 require("LuaPanda").start(ip, port) 中的端口即可 ）

如果希望在一个VSCode窗口中连接多个lua虚拟机，就要用到多目标调试。如下图，一个 VSCode 窗口同时和两个虚拟机建立了连接，Project1 和 Project2 分别独立运行，通过切换堆栈可以分别观察它们的状态。

要如何进行多目标调试呢？ LuaPanda支持两种方式：

1. 多个项目放在同一个workspace中

• 打开workspace, 发现存在两个项目 project1 和 project2. 切换到调试选项卡，可以分别给两个项目增加配置。

• 如果两个项目之前单独调试过，那么配置文件应该是已存在的。分别创建两个项目的配置后，修改他们的配置名和端口号，使之不同，避免相互干扰。

• 在vscode窗口中运行两个目标。分别在两个lua虚拟机的代码中引用调试器（注意保持端口一致），之后启动虚拟机，即可分别建立连接，开始调试。

2. 多个项目放置在同一个工程中

这种情况下，一个文件夹中的 lua 代码分别运行在两个虚拟机，配置方法如下

• 打开上层公共文件夹

• 建立launch.json文件: 切换到debug选项卡，创建一份launch.json 配置文件

• 修改 launch.json。 复制一份 LuaPanda 配置，并修改name和port, 使之不同，如下图

• 在VScode中启动两个目标，在两个lua虚拟机运行的lua代码中分别引用调试器（注意设置端口），运行各lua虚拟机，即可开始调试。

独立文件调试说明(debugging independent file)

什么是独立文件

我们这里的 独立文件 指的是不依赖于 其他模块/特定运行环境/特定框架 的 lua 文件。

即存在一个文件 a.lua 用户执行

lua a.lua

注意：此模式下无需加入require("LuaPanda"), 调试器会自动引用。

把调试选项切换至LuaPanda-DebugIndependentFile, 代码编辑窗口切换到待调试文件，点击下图绿色箭头或按F5运行。

调试独立文件

VSCode 会启动一个新终端，调用 lua 命令来执行当前打开的lua代码。

把代码编辑窗口切换到待执行文件（让待执行文件的窗口处于激活状态），然后如下图操作。

快速运行独立文件

如果希望使用运行独立文件，第一步是建立 launch.json ，可以参阅文档，这里不再重复。

就可以正确运行，并输出运行结果的文件。调试器执行独立文件也正是调用了上面的命令，这些被执行的命令可以从vscode的终端里看到。

VSCode ssh远程调试

Vscode 有非常强大的远程插件机制，通过 Remote-SSH 插件就可以实现。远程插件这里不做详细介绍，LuaPanda 支持远程调试，唯一要注意的是打开的文件夹中不要包含中文或异常符号，在一些平台上（如 linux）会因为这些符号导致问题。