MindStudio Debugger

昇腾 AI 算子调试工具¶

🔹 [2025.12.31]：MindStudio Debugger 项目全面开源

MindStudio Debugger（算子调试工具，msDebug）是基于 LLVM 编译器基础设施构建、面向昇腾设备的算子调试工具，用于调试在 NPU 侧运行的算子程序，为开发者提供关键调试能力，包括读取昇腾设备内存与寄存器、暂停与恢复程序执行状态等。

^{图示：算子上板调试断点设置、变量打印、单步调试等操作演示}

msDebug工具支持调试所有的昇腾算子，包含Ascend C算子（Vector、Cube以及Mix融合算子）程序，用户可根据实际情况进行选择，支持的功能如下：

功能名称	功能描述
断点设置	可在算子的运行程序上设置行断点，即在算子代码文件的特定行号上设置断点。
打印变量和内存	根据变量类型和用法，变量可以存储在寄存器中或存储在Local Memory、Global Memory内存中，用户可以打印变量的地址以找出它的存储位置并进一步打印关联的内存。
单步调试	需要了解代码执行具体情况时，可进行单步调试。
中断运行	当算子运行程序卡顿时，手动中断算子运行程序并回显中断位置信息。
核切换	可将当前聚焦的核切换至指定的核，切核后会自动展示指定核代码中断处的位置。
检查程序状态	当调起算子后，可读取当前断点所在设备的寄存器值，检查程序状态。
调试信息展示	查询算子运行的设备信息。
解析Core dump文件	通过对异常算子dump文件的解析，即使在没有主动压测的情况下也能收集到足够的数据用于问题分析。

详细操作步骤请参见《msDebug 快速入门》。

介绍工具的环境依赖与安装方法，请参见《msDebug 安装指南》。

工具的详细使用方法，请参见《msDebug 使用指南》。

通过典型问题场景帮助用户理解并掌握工具使用，请参见《msDebug 典型案例》。

常见问题及解决方案，请参见《msDebug FAQ》。

欢迎参与项目贡献，请参见《贡献指南》。

欢迎大家为社区做贡献。如果有任何疑问或建议，请提交Issues，我们会尽快回复。感谢您的支持。

📱 关注 MindStudio 公众号	💬 更多交流与支持
_{扫码关注获取最新动态}	💡 加入微信交流群：关注公众号，回复“交流群”即可获取入群二维码。 🛠️ 其他渠道： 👉 昇腾助手： 👉 昇腾论坛：

本工具由华为公司的下列部门联合贡献：
🔹 昇腾计算MindStudio开发部
🔹 昇腾计算生态使能部
🔹 华为云昇腾云服务
🔹 2012编译器实验室
🔹 2012马尔科夫实验室
感谢来自社区的每一个 PR，欢迎贡献！