Skip to content

Latest commit

 

History

History
102 lines (51 loc) · 4.14 KB

FAQ.md

File metadata and controls

102 lines (51 loc) · 4.14 KB

FAQ

[TOC]

发布环境中请勿使用调试器

调试器本身对lua执行效率有一定影响，请在正式发布环境中清除调试器相关代码，包括

  • require("LuaPanda").start();
  • LuaPanda.BP()
  • LuaPanda.getInfo()
  • LuaPanda.getCWD()
  • LuaPanda.getBreaks()

文件路径大小写敏感的设置

  • 如果在运行时获得的文件路径大小写和实际的文件不一致，可以设置launch.json中pathCaseSensitivity 项为false。

  • 大小写敏感设置是为了解决有些框架中传给lua虚拟机的路径被转换为了小写的，导致命中断点时路径无法匹配的问题。

查看调试日志

  • 调试器自带日志模块，方便追踪问题。使用方法是切换到console的OUTPUT(输出)页卡, 选择 Adapter/log 或者 Debugger/log 就可以查看对应的日志。
  • 通常看Adapter就可以展示Adapter和Debugger的交互信息。
  • 如果需要更全面的日志，可以调整launch.json中的logLevel:0，再查看Debugger日志，可以输出每行执行到的文件信息。因日志较多，level设置为0可能会造成卡顿（0级日志主要用于调试器开发，使用时开1级日志就可以）。

可否调试协程

可以，在协程中可以下断点进行调试。要注意的是，协程中的调用栈仅显示携程内的调用信息。

调试器的路径处理规则

在调试控制台中输入LuaPanda.getCWD()或直接调用会返回三条路径

cwd:      工程中launch.json中cwd设置项的路径
getinfo:  从lua虚拟机中获取的当前执行的文件路径
format:   cwd + getinfo
  • 如果getinfo获取了相对路径，那么会用cwd + 相对路径拼接成文件完整路径。如果getinfo获取了绝对路径，那么忽略cwd，直接使用这个绝对路径
  • format路径是调试器认为的文件有效路径。用来做断点判断和通知vscode打开文件。如果vscode提示文件找不到，就是format路径错误了。
  • getinfo难以调整。通常是调整cwd已获得正确的format路径。调整方法包含更改vscode打开的目录层级，也可以直接修改launch.json中cwd设置。

为什么调试时提示找不到文件

说明上一条路径处理规则中提到的format路径不正确。

解决办法：

不要停止调试，直接在调试控制台中输入LuaPanda.getCWD()。看一下format路径是否多了或者缺少层级。

  • 如果是路径错了，调整cwd，可以增加路径层级或是/../保证拼接后的路径正确。

  • 如果是format的文件后缀有误，按上面的说明修改后缀。

关于硬断点

  • 调试器提供了硬断点，在用户代码里调用LuaPanda.BP()就可以硬性设置一个断点。
  • 硬断点不需要做断点匹配，也不改变调试器hook状态和影响调试器效率。执行到这一行时会被强行停止。

执行到断点处无法停止

通常遇到的情况是stop on entry时可以停止，但是后续或者子文件的断点无法停止。

这种情况是断点路径和当前文件format路径对比不一致导致的，因为用户环境多样，可使用下面方法定位问题：

  1. 打开launch.json的stopOnEntry
  2. 在断点未停的位置，保持断点并在源码中加入一行代码LuaPanda.BP().
  3. 再次运行项目，让项目运行并停止在LuaPanda.BP() (此处也可能会报错找不到文件，不要停止调试，进行下一步)。
  4. 在控制台输入LuaPanda.doctor(), 查看给出的路径建议中 filepath和getinfo是否一致，根据具体情况调整直到二者一致即可。

VSCode端无法和lua建立连接

  • 在无自定义主题的情况下，建立连接前VSCode下端状态栏为蓝色，建立连接后变为橙色
  • 检查require("LuaPanda").start("127.0.0.1",8818);和launch.json中工程配置的端口号是否一致，并尝试重启VSCode。

真机调试要的注意事项

  • 手机和pc处于同一网段
  • 手机端App集成luasocket
  • 路径问题：真机中回传lua路径和pc是不同的，这时候需要lua在手机中的路径结构和pc中一致。以便调试器可以用cwd(工程文件夹) + getinfo(文件相对路径)找到对应文件。