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文件的解析，即使在没有主动压测的情况下也能收集到足够的数据用于问题分析。

为提升文档查阅效率，我们提供多种高效检索方式： 🔹 AI 问答（DeepWiki）：自然语言问答，快速把握项目架构与模块关系。 🔹 AI 问答（ZRead）：中文问答体验更优，精准定位功能用法与细节。 🔹 精确搜索（ReadTheDocs）：关键词全文检索，直达接口、参数与报错等信息。

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

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

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

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

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

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

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

即时互动（微信群）	官方资讯（公众号）	深度支持（助手/论坛）
_{扫码加入技术交流群}	_{扫码关注官方公众号}	扫码入群并关注公众号，直达 MindStudio 用户与开发者最快捷的交流平台：快速提问：与社区小伙伴即时探讨技术问题掌握动态：第一时间获取版本发布与功能更新通知经验共享：与广大开发者交流最佳实践与实战心得更多支持渠道：👉 昇腾助手： 👉 昇腾论坛：

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