x64dbg 脚本 msg 命令详解：消息框弹窗、字符串格式化与桥接实现

x64dbg 脚本 msg 命令详解：消息框弹窗、字符串格式化与桥接实现

【免费下载链接】x64dbgAn open-source user mode debugger for Windows. Optimized for reverse engineering and malware analysis.项目地址: https://gitcode.com/gh_mirrors/x6/x64dbg

msg是 x64dbg 脚本系统中用于弹出消息框（Message Box）的核心命令，允许脚本在运行时向用户展示任意文本，并天然支持内置的字符串格式化能力。本文以 msg 命令官方文档为骨架，结合 cmd-script.cpp 与 bridgemain.cpp 的源码实现，系统讲解 msg 的语法、格式化技巧、与 msgyn 等兄弟命令的差异、底层调用链及真实脚本场景中的使用要点。

命令速览

msg是 x64dbg 的脚本专用命令（Script Command），根据 docs/commands/script/index.rst 的说明，这一节收录的是"仅在脚本上下文中使用或可用的命令"，因此它主要出现在.txt脚本文件中，配合scriptload/scriptrun执行，也可以在命令行输入框中直接使用。

• 功能：显示一个消息框（Message Box）。
• 参数：arg1为消息框文本，支持字符串格式化。
• 返回值：本命令不设置任何结果变量，即不会影响$result/$RESULT。

msg "你的消息文本"

消息框是阻塞式的：脚本执行到msg时会暂停，直到用户在界面上点击"确定"后才继续执行下一行。如果需要让用户做"是 / 否"选择，请改用msgyn（见下文）。

参数与字符串格式化

msg的唯一参数arg1是待显示的文本。x64dbg 会先对这段文本执行内联字符串格式化（inline string formatting），再将其交给 GUI 层弹出消息框。

格式化语法

x64dbg 内置的字符串格式化器采用{?:expression}语法，其中?是可选的表达式类型，expression是任意合法的表达式。在msg文本中直接嵌入花括号表达式即可，例如：

msg "当前寄存器: rax={rax} rbx={rbx}"

常用格式化类型（完整清单见 Formatting.md）：

类型	含义	示例输出
d	有符号十进制	-3
u	无符号十进制	57329171
p	零前缀指针	0000000410007683
s	字符串指针	"this is a string"
x	十六进制（整数值默认类型）	3C28A
a	地址信息	00401010 <module.EntryPoint>
i	指令文本	jmp 0x77ac3c87
f/F	单精度 / 双精度浮点（支持 XMM、YMM、ZMM）	3.14
{mem;size@address}	从地址读取size字节并以十六进制打印	{mem;8@rax}
{ascii;length@address}	打印指定地址的 ASCII 字符串	{ascii@401000}
{utf16;length@address}	打印指定地址的 UTF-16 字符串	{utf16@4*ecx+0x402000}
{disasm@address}	打印该地址的反汇编	等价于{i:address}
{winerror@code}	打印 Windows 错误码的名称与描述	{winerror@GetLastError()}
{ntstatus@code}	打印 NTSTATUS 错误码的名称与描述	类似 ErrLookup

需要输出字面量{或}时，使用{{与}}转义。

实战示例

; 展示一个 8 字节内存块的十六进制内容 msg "内存数据: {mem;8@[rbp-0x10]}" ; 展示一条反汇编 msg "当前指令: {i:cip}" ; 展示模块名与地址信息 msg "所在模块: {modname@cip} 地址: {a:cip}" ; 展示 UTF-16 字符串 msg "明文密码: {utf16@0x402000}"

引号与分号注意事项

脚本命令之间使用;分隔（脚本语法），而字符串格式化中的复杂类型同样包含;（如{mem;8@rax}）。为了避免解析歧义，格式化文本务必使用双引号包裹，这与log命令的建议一致（见 Formatting.md 的 Logging 一节）：

msg "{mem;8@rax}" ; 正确：整个格式化串被引号保护 msg {mem;8@rax} ; 错误：分号可能被当作命令分隔符

源码级原理：msg 的完整调用链

msg的命令处理函数位于 src/dbg/commands/cmd-script.cpp：

bool cbScriptMsg(int argc, char* argv[]) { if(IsArgumentsLessThan(argc, 2)) return false; GuiScriptMessage(stringformatinline(argv[1]).c_str()); return true; }

其执行流程可以拆解为三个环节：

1. 参数校验：IsArgumentsLessThan(argc, 2)确保命令至少携带了一个文本参数，否则直接返回false（命令失败）。
2. 内联格式化：stringformatinline(argv[1])对原始文本执行字符串格式化，将{rax}、{mem;8@...}等表达式替换为实际值。这也是msg文本中能直接嵌入寄存器、内存与表达式的原因。
3. 跨层消息传递：GuiScriptMessage是 debug 层暴露给 GUI 层的桥接函数，定义于 src/bridge/bridgemain.cpp：

BRIDGE_IMPEXP void GuiScriptMessage(const char* message) { _gui_sendmessage(GUI_SCRIPT_MESSAGE, (void*)message, 0); }

它通过_gui_sendmessage将消息发送给 GUI 线程，最终由界面层渲染成原生消息框。类似的桥接接口还有GuiScriptMsgyn（bridgemain.cpp，发送GUI_SCRIPT_MSGYN并返回用户选择结果）。

命令注册

msg与msgyn在调试器启动阶段统一注册，见 src/dbg/x64dbg.cpp：

dbgcmdnew("msg", cbScriptMsg, false); dbgcmdnew("msgyn", cbScriptMsgyn, false);

注册时第三个参数为false，表示这些命令不要求调试目标处于运行状态，脚本在任何阶段都可以弹出消息框。

脚本 API 中的对应接口

除命令行命令外，脚本 API（Script API）也暴露了等价能力。src/dbg/_scriptapi_gui.cpp 中的Gui.Message/Gui.MessageYesNo内部即直接调用上述两个桥接函数：

GuiScriptMessage(message); return !!GuiScriptMsgyn(message);

因此 C/C++ 插件或调用脚本 API 的外部程序也可以复用同一套消息框机制。

阻塞行为与调试器的内部使用

msg是同步阻塞命令，弹窗期间脚本执行暂停，等待用户点击确定。这一阻塞语义在调试器内部同样被复用——例如 src/dbg/debugger.cpp 在需要用户确认是否继续调试时，正是通过GuiScriptMsgyn(message.c_str())获取用户决策；src/dbg/simplescript.cpp 在脚本异常时也借助GuiScriptMessage弹出错误提示，并在 simplescript.cpp 用GuiScriptMsgyn询问"脚本已运行较长时间，是否终止"。

从源码结构可以推断：msg系列命令不仅是脚本作者的 UI 工具，也是 x64dbg 自身"向用户传达信息 / 征求确认"的统一基础设施。

与 msgyn、log、pause 等命令的分工

脚本命令族中与msg最容易混淆的是msgyn、log与pause，建议按以下场景取舍：

命令	用途	是否阻塞	是否设置结果变量
msg	弹出仅带"确定"按钮的消息框	是	否
msgyn	弹出"是 / 否"消息框	是	是（$result= 1 为是，0 为否）
log	向日志窗口输出文本（不弹窗）	否	否
pause	暂停脚本执行	是	否

选择建议：

• 仅展示信息、无需交互→ 优先用log写日志，避免弹窗打断自动化流程；确需醒目提示时用msg。
• 需要用户决策→ 用msgyn并检查$result：

msgyn "是否继续分析？" cmp $result, 1 jne $EXIT

• 脚本调试断点→ 用pause或临时msg观察变量。

完整脚本示例

以下脚本演示msg与格式化、条件分支的组合用法（可在 x64dbg 命令行scriptload加载执行）：

; msg-demo.txt —— msg 命令综合示例 mov eax, 0x1234 msg "eax = {eax} (十进制 {d:eax})" msg "当前指令: {i:cip}" msg "模块入口: {a:mod.base()}" msgyn "是否继续？" cmp $result, 0 jne continue msg "用户选择退出" ret continue: msg "继续执行脚本"

执行要点：

1. msg文本必须用双引号包裹，尤其是包含{mem;...@...}、{ascii;...@...}这类带分号的复杂格式化时；
2. msg不会污染$result，因此不会干扰后续$result相关的逻辑判断；
3. 弹窗期间脚本阻塞，若脚本在调试事件回调中执行，注意避免长时间等待导致调试流程停滞。

小结

• msg是 x64dbg 脚本系统中"弹出文本消息框"的标准命令，语法为msg "文本"，唯一参数支持完整的内联字符串格式化。
• 它不设置任何结果变量；需要"是 / 否"反馈时使用msgyn，其返回值写入$result。
• 实现上由cbScriptMsg→stringformatinline→GuiScriptMessage（桥接GUI_SCRIPT_MESSAGE）构成完整调用链，相关代码可在 cmd-script.cpp、x64dbg.cpp 与 bridgemain.cpp 中查阅。
• 推荐的后续阅读：msgyn 命令文档、字符串格式化完整参考、表达式语法。

【免费下载链接】x64dbgAn open-source user mode debugger for Windows. Optimized for reverse engineering and malware analysis.项目地址: https://gitcode.com/gh_mirrors/x6/x64dbg