MacOS Xcode 使用LLDB调试Qt的 QString_C/C++

环境：

macos： 14.3
xcode： version 15.0
qt：qt 6.5.3

前言

xcode 中显示预览 qstring 特别不方便, 而qt官方的 lldb 脚本debugger/lldbbridge.py一直加载失败，其他第三方的脚本都不兼容当前的环境。所以自己研究写了当前的教程。
当前方法同样适用于其他非苹果内置类型的预览和显示。

原始效果如下：
在这里插入图片描述
优化后的效果：

创建步骤：

检测 ~/.lldbinit 文件
判断文件是否存在，不存在则创建。
每次 lldb 启动都会加载 ~/.lldbinit 文件的命令，可以理解为存在硬盘里面的默认用户配置。
创建 python 脚本文件
在任意路径创建一个python 文件。我这里创建的python文件的路径为：~/documents/source/pytest/lldb_qt_value.py

~/.lldbinit 写入命令
这里lldb 在初始化的时候就会导入这个python文件

# 加载 lldb 预览 qt 内置成员的 脚本
command script import '~/documents/source/pytest/lldb_qt_value.py'

回到 lldb_qt_value.py 文件，写具体脚本

import lldb

def qstring_summary(value, internal_dict):
    summary = value.getchildmemberwithname('d').getchildmemberwithname('ptr').getsummary()
    if summary == "summary unavailable":
        return none
    return summary[2:-1]

# lldb 的 默认初始化 函数
def __lldb_init_module(debugger, internal_dict):
    debugger.handlecommand('type summary add qstring -f lldb_qt_value.qstring_summary')
    print('lldb_qt_value.py 正在为您服务.')

具体逻辑如下：

lldb 初始化调用 __lldb_init_module 函数
创建一个 qstring 的钩子函数。函数为 lldb_qt_value 文件的 qstring_summary方法。
初始化会在控制台打印 'lldb_qt_value.py 正在为您服务.'
当 qstring 类型被预览时(或者控制台输入 po 或 p 命令) 会进入这个函数qstring_summary
获取我们准备替换显示的值, 获取路径为test1 -> d -> ptr -> summary.
具体对应这个代码 summary = value.getchildmemberwithname('d').getchildmemberwithname('ptr').getsummary()
判断如果是空的就返回 null
不为空则去除前面两个字符 u" 和最后一个 "。从u"abc测试" -> abc测试
返回处理后的值，供lldb 预览显示

结果

qstring 和 std::vector<qstring> 和其他包含qstring的类型都可以正确格式化。
如果需要其他 qt 类型或者自定义类型都可以用此方法显示。

在这里插入图片描述
最终脚本预览如下：
加上 qbytearray 的自定义显示后：

import lldb

#command script import '~/documents/source/pytest/lldb_qt_value.py'

def qbytearray_summary(value, internal_dict):
    if value is none:
        return none
    return value.getchildmemberwithname('d').getchildmemberwithname('ptr').getsummary()

def qstring_summary(value, internal_dict):
    summary = value.getchildmemberwithname('d').getchildmemberwithname('ptr').getsummary()
    if summary == "summary unavailable":
        return none
    return summary[2:-1]

# lldb 的 默认初始化 函数
def __lldb_init_module(debugger, internal_dict):
    debugger.handlecommand('type summary add qstring -f lldb_qt_value.qstring_summary')
    debugger.handlecommand('type summary add qbytearray -f lldb_qt_value.qbytearray_summary')
    print('lldb_qt_value.py 正在为您服务.')