欢迎来到 MemScope 内存分析工具中文教程 ✨

🌟 最新动态

[2026.2.02] 🎉 MindStudio Memscope 26.0.0-alpha.1版本上线！ 支持Python API采集方式使用、支持PyTorch框架下采集内存快照、支持识别显存页表属性并进行落盘、支持获取Driver新增的显存分配接口。
[2025.12.30]：MindStudio Memscope项目首次上线。

🌏 简介

MindStudio MemScope（内存分析工具，msMemScope）是基于昇腾硬件开发，用于模型训练与推理过程中的内存问题定位的工具。该工具提供内存泄漏检测、内存对比、内存块监测、内存拆解和低效内存识别等功能，帮助用户完成问题定位与处理。

🚀 核心功能

msMemScope工具提供内存采集、内存分析两大功能。

功能	功能说明	详细功能	使用场景及说明
内存采集	msMemScope工具提供内存事件的采集能力，允许自定义设置采集内存范围和采集项，为后续分析提供原始数据。	Python接口方式采集	支持通过Python接口采集信息，提供自定义设置采集内存范围和采集项，采集内存事件和Python Trace事件能力，实现精准采集、高效分析。
内存采集	msMemScope工具提供内存事件的采集能力，允许自定义设置采集内存范围和采集项，为后续分析提供原始数据。	命令行方式采集	支持通过命令行方式采集信息，提供在非Python场景下采集内存事件与内存分析能力。
内存分析	msMemScope工具基于采集的内存数据，提供泄漏、对比、监测、拆解、低效识别五项分析能力，帮助开发者快速诊断和优化内存问题。	内存泄漏分析	针对内存长时间未释放和内存泄漏等问题，需要进行内存分析时，msMemScope工具提供内存泄漏分析和kernelLaunch粒度的内存变化分析功能，进行告警定位与分析。
		内存对比分析	当两个Step内存使用存在差异时，可能会导致内存使用过多，甚至出现OOM（Out of Memory，内存溢出）的问题，则需要使用msMemScope工具的内存对比分析功能来定位并分析问题。
		内存块监测	在大模型场景中，当遇到内存踩踏定位困难时，msMemScope工具支持通过Python接口和命令行两种方式，在算子执行前后对指定的内存块进行监测。根据内存块数据的变化，快速确定算子间内存踩踏的范围或具体位置。
		内存拆解	msMemScope工具提供内存拆解功能，支持对CANN层和Ascend Extension for PyTorch框架的内存使用情况进行拆解，输出模型权重、激活值、梯度，以及优化器等组件的内存占用情况。
		低效内存识别	在训练推理模型过程中，可能会存在部分内存块申请后未立即使用，或使用完毕后未及时释放的低效情况。msMemScope工具可帮助识别这种低效内存的使用现象，从而优化训练推理模型。

👉 推荐上手路径

为了帮助用户快速上手 MemScope 内存分析工具，我们推荐按照以下顺序进行学习：

对于想要使用 MemScope 内存分析工具的用户，建议先阅读安装指南，确保环境配置正确。
本教程提供的快速入门将引导你完成基本的内存问题定位配置和运行。
详细功能部分将介绍内存采集、内存分析以及输出文件说明等内容，帮助你更好地理解内存问题定位的场景。
msMemScope工具提供API接口，便于快速分析内存情况，具体使用方法可以参考 API使用。
你可以参考开发者指南部分，了解在 MemScope 内存工具的开发步骤。

📬 建议与交流

华为MindStudio全流程开发工具链团队致力于提供端到端的昇腾AI应用开发解决方案，使能开发者高效完成训练开发、推理开发和算子开发。您可以通过以下渠道更深入了解华为MindStudio团队：

昇腾论坛：

昇腾小助手：

欢迎大家为社区做贡献。如果有任何疑问或建议，请参考交流指南获取详细的联系方式和支持渠道。

:maxdepth: 2
:caption: 🚀 开始你的第一步
:hidden:

install_guide
quick_start

:maxdepth: 1
:caption: 🧭 详细功能
:hidden:

memory_profile
memory_analysis
output_file_spec

:maxdepth: 2
:caption: 🔬 API接口
:hidden:

api

:maxdepth: 2
:caption: 💪 开发者指南
:hidden:

development_guide/development_guide.md

:maxdepth: 2
:caption: 🔍 交流指南
:hidden:

communication_guide/communication.md