我是兰瓶Coding，一枚刚踏入鸿蒙领域的转型小白，原是移动开发中级，如下是我学习笔记《零基础学鸿蒙》，若对你所有帮助，还请不吝啬的给个大大的赞~

前言

说句大实话：应用“卡到怀疑人生”的那一刻，八成不是 CPU 在摸鱼，而是内存在暗中搞事情。对象回不去、图片没释放、事件监听像藤蔓一样攀爬，久而久之就炸。别慌，这篇我就按你给的路线打通：内存模型 → 泄漏定位 → 工具使用，围绕 DevEco Studio 的 Memory Profiler（Allocation / Memory 泳道） 与 Heap Analyzer（Snapshot Insight 堆快照分析），再补上 ASan/HWASan、HiDumper、rawheap_translator 这些“救火扳手”。要代码、有步骤、有避坑，还得有点“人味儿”。开整！💥

一、内存模型：先把“水往哪儿流”搞明白

1) 三个最常用指标：PSS / RSS / USS（看懂曲线，才能少走弯路）

• PSS（Proportional Set Size）：独占内存 + 共享库按比例分摊的那部分。更贴近“这进程真算占了多少”。
• RSS（Resident Set Size）：独占 + 相关共享库全部算上。
• USS（Unique Set Size）：只看独占内存，最直观地反映“自己长没长肉”。
  在 DevEco Profiler 的 Memory 视图里，这三条泳道能一起看，抖一下、飙一下，一目了然。(华为开发者官网)

小经验：USS 连续台阶式上涨且回不去，多半是泄漏；PSS 突增常见于加载了“胖依赖/大资源”；RSS 持续高位可能有长驻缓存或大图未回收。参考官方的 Profiler 内存问题定位文章及社区实战。(华为开发者官网)

2) 混合堆的现实：ArkTS Heap × Native Heap

HarmonyOS 原生应用常见“双生态”：

• ArkTS（方舟 VM）对象堆：页面状态、组件树、闭包、定时器等。
• Native 堆：NAPI/C++ 层、解码器、图像缓冲、第三方库。
  Profiler 的 Allocation / Snapshot 模板都能分别观察 ArkTS 与 Native 的分配/对象；要定位跨语言的泄漏，得两套一起看。(掘金)

3) 系统侧辅助：HiDumper 与体检工具

• HiDumper：命令行导出系统/进程内存，hdc shell hidumper --mem [pid] 可看进程级占用概况，做“远观趋势”很方便。(华为开发者官网)
• AppAnalyzer（应用与元服务体检）：一键跑用例，自动收集 trace / 内存快照（snapshot），还能一键回到 Profiler 做深挖。(华为开发者官网)

二、泄漏定位：从“怀疑”到“实锤”的三板斧

整体打法：实时监控（发现异常）→ 分配追踪（定界谁在涨）→ 堆快照对比（找出是谁没走）→ 还原引用链（为什么走不了）。

板斧 A：先用 Memory 泳道“看走势”

• 在可复现的场景里（例如“打开列表 → 无限滚动 → 退回”），盯 USS/PSS。
• 若每次进入/退出页面内存都涨一截，基本可以判泄漏趋势成立。(掘金)

板斧 B：切换 Allocation（Memory Profiler）看“谁在疯狂分配”

• ArkTS Allocation：看对象类型、分配点、调度线程；
• Native Allocation：看 malloc/mmap、分配栈、SO 维度统计、未释放块；
• 支持在会话中框选时间段对比分配/释放情况。(华为开发者官网)

板斧 C：抓两张 Heap Snapshot 对比（Heap Analyzer 实战）

• 在“进入页面 10s”与“退出页面 10s”分别抓快照；
• 对比对象数量/保留大小，锁定“退出后仍存活”的族群；
• 观察 Dominators / Retainers（主导/持有者），找出那条把对象“绑住”的引用链条；
  DevEco 的 Snapshot Insight 就干这个活，原理等同“Heap Analyzer”。(掘金)

离线分析：如果拿到设备侧 .rawheap，可用 rawheap_translator 转成 .heapsnapshot，再导入 DevEco Studio 或 Chrome DevTools 的 Memory 工具继续看 对象/引用/保留大小。这条链路在 OpenHarmony 官方文档里有明确说明。(GitCode)

---

三、常见“真凶”与可复制的修复套路（ArkTS × Native）

1) ArkTS 侧高频坑

🕳️ 事件监听没解绑 / 订阅漏清

// ❌ 问题：页面走了，回调还握着闭包上下文
onPageShow = () => eventBus.on('topic', this.onMsg); // 注册在全局

onPageHide = () => {
  eventBus.off('topic', this.onMsg); // ✅ 成对解绑
}

• 症状：页面退出后 USS 不降；快照里能看到页面对象被某个“全局监听回调”持有。
• 修复：生命周期里成对注册/解绑；对“一次性”监听用 once；对跨页面总线封装“自清理”基类。

🕳️ 定时器/工作线程没停

// ❌ 问题：定时器持有闭包，页面没了它还在跑
let t: number | undefined;
onAppear() { t = setInterval(()=> this.tick(), 1000); }
onDisappear() { if (t) clearInterval(t); t = undefined; } // ✅ 记得清

• Worker 同理：退出前 worker.terminate()，并清掉与 UI 的消息桥。

🕳️ 大图 / PixelMap 没释放

• XComponent/PixelMap 从 ImageReceiver 或解码器拿到后，一定要在不用时 release()；否则 Native 侧缓冲持续占用，表现为 Native Allocation 未释放。
• 在图片列表里做尺寸收敛（按 UI 尺寸解码）与复用，避免把 4K 图塞进 200px 的卡片里（分分钟 USS 爆涨）。

🕳️ 缓存 Map/Set 没上限

• “聪明”的 LRU 才是缓存，无上限的 Map 只是泄漏的另一个别名。给缓存加上容量，超限淘汰。

2) Native / NAPI 侧高频坑

🕳️ 忘记释放 NAPI 引用

// ❌ 创建了强引用但没 delete
napi_ref ref;
napi_create_reference(env, jsObj, 1, &ref);
// ... 以后不再使用:
// ✅
napi_delete_reference(env, ref);

• Snapshot 可能看不出（它更偏 ArkTS 堆），但 Native Allocation 泳道会显示未释放块和调用栈。(华为开发者官网)

🕳️ new/malloc 成对不一致，或异常路径遗漏 free

• 用 ASan/HWASan 抓“第一现场”，尤其是越界写或悬挂指针。DevEco 支持一键启用 ASan，并通过 ASAN_OPTIONS 调整行为（注意与 TSan/HWASan 互斥）。(华为开发者官网)

---

四、工具使用：从“打开方式”到“落地手法”

下文以 DevEco Studio 5.x 为例，真机 Debug 构建体验最佳；Allocation/Native Allocation 等部分能力对上架应用有限制（隐私政策），开发期请用调试包。(华为开发者官网)

1) 打开 Memory Profiler（Allocation / Memory 泳道）

1. DevEco Studio 底部工具栏点 Profiler（或 View → Tool Windows → Profiler）。
2. 选设备与进程，挑 Allocation 模板，Create Session。
3. 关注左侧泳道：Memory / ArkTS Allocation / Native Allocation，必要时框选时间段，看右侧详情的统计、调用栈、分配列表、SO 维度。(华为开发者官网)

你会用到的关键视图

• Memory（PSS/RSS/USS）：看趋势。
• ArkTS Allocation：看 JS/ArkTS 对象、分配点、线程。
• Native Allocation：看 malloc/mmap、未释放大小、分配栈；按 SO / 调用库 过滤定位第三方库热区。(华为开发者官网)

2) Heap Analyzer：Snapshot Insight（堆快照对比）

1. 在 Snapshot 模板下创建会话；或在 Allocation 会话中抓取快照。

2. 抓 基线快照 A（进入页面稳定后），做操作，再抓 快照 B（退出或回到列表）。

3. 打开 Snapshot Insight 对比 A/B：

   • 看对象 数量/大小 的差异；
   • 关注“保留大小”最大的对象族群；
   • 展开引用链（谁在持有它们），定位“根因对象”。(掘金)

离线/跨端分析：若手上是 .rawheap，用 rawheap_translator 转 .heapsnapshot，可直接导入 DevEco Studio 的堆视图或 Chrome DevTools 的 Memory 工具。官方文档给了转换与导入流程。(GitCode)

3) ASan / HWASan：C/C++ “踩内存”定位

• 在 DevEco 的 Run/Debug Configurations 或 app.json5 里配置 ASAN_OPTIONS 等环境变量，构建 Debug 包后运行，即可在日志里拿到越界/Use-After-Free 的第一时间报告。注意 ASan/TSan/HWASan 互斥。(华为开发者官网)

4) HiDumper：系统侧“卫星视角”

• hdc shell hidumper --mem [pid]：看进程内存总览；
• --zip 可把报告打包到 /data/log/hidumper 拉回本地；
• 适合持续集成里做基线巡检，发现异常再开 Profiler 精查。(华为开发者官网)

5) AppAnalyzer：一键体检 + 回链 Profiler

• Tools → AppAnalyzer，选模块与规则集（如 Benchmark），自动遍历并导出报告；
• 报告里会给出 profiler / snapshot 文件，点击可直接拉起 Profiler 进入定位。(华为开发者官网)

---

五、实操剧本：30 分钟把一次“页面退出不降内存”锤死

前提：该页面可能漏了事件解绑/定时器/Bitmap。

1. 录制 Allocation（10 分钟内）

   • 进入页面后稳定 10 s → 点击 Record；
   • 滚动/切换 → 退出页面 → 停止录制；
   • 看 USS 曲线：若退出后仍高，基本坐实泄漏。(掘金)

2. ArkTS vs Native 分层定界（5 分钟）

   • ArkTS Allocation：看是否有某类 UI/数据对象数量只增不减；
   • Native Allocation：看 Statistics / Call Trees / Allocations List 是否存在Created & Existing 大量残留；
   • 初步判断“JS 对象 or Native 资源”。(华为开发者官网)

3. 堆快照对比（10 分钟）

   • 抓 A（进页后） 与 B（退页后）；
   • 在 Snapshot Insight 中排序看“保留大小”，点进去看Retainers 引用链；
   • 一般会看到“全局事件回调 / 未清理的闭包 / 未释放的 PixelMap”。(掘金)

4. 修复与验证（5 分钟）

   • 加上解绑/清理/释放；
   • 同场景复测，曲线回落，A/B 对比消失，收工。

---

六、ArkTS & Native 代码侧“即插即用”的自检清单

ArkTS

• 监听/订阅：成对 on/off，支持页面 aboutToDisappear/onPageHide 清理。
• 定时器/Worker：clearInterval/terminate，Promise 回调里注意弱持有 UI。
• 图片/PixelMap：使用完 release()；解码按目标尺寸；列表滑动中去抖预取。
• 缓存：固定容量（LRU），避免 Map/Set 无上限增长。
• 跨模块引用：谨慎把 UI/大对象塞进单例；必要时存可序列化数据而不是活对象。

Native / NAPI

• napi_ref：有借有还；napi_delete_reference。
• 内存所有权：明确 malloc/free、new/delete 成对；异常路径加 unique_ptr/RAII。
• 图片/解码/Buffer：明确释放时机；避免“多处共享 + 不清楚谁负责回收”。
• ASan/HWASan：开发期开启，回归前跑一轮关键路径。(华为开发者官网)

自动化 & 环境

• HiDumper 基线：CI 按关键页面流转跑 hidumper --mem [pid]，抓峰值。(华为开发者官网)
• 体检工具：每周跑一次 AppAnalyzer，导回 Profiler 二次分析。(华为开发者官网)
• 离线堆分析：保存 .rawheap → rawheap_translator → .heapsnapshot，沉淀“泄漏图谱”。(GitCode)

---

七、两个“能复用”的 Demo 片段

Demo 1：页面退出不降，因事件未解绑

// ❌ 有监听，无解绑
eventBus.on('user:update', this.onUser);

// ✅ 封装成“可自动解绑”的小工具
class ScopedSlots {
  private unsubs: (()=>void)[] = [];
  on<T>(bus: Bus<T>, t: string, fn: (v:T)=>void) {
    bus.on(t, fn); this.unsubs.push(()=>bus.off(t, fn));
  }
  dispose(){ this.unsubs.forEach(x=>x()); this.unsubs=[]; }
}

@Entry
@Component
struct UserPage {
  private scope = new ScopedSlots();
  aboutToAppear() { this.scope.on(eventBus, 'user:update', this.onUser); }
  aboutToDisappear() { this.scope.dispose(); } // ✅ 一次性清干净
}

Demo 2：Native Buffer 未释放 → Allocation 展示“Created & Existing”堆积

// ❌ 漏 free
void DoWork(size_t n) {
  void* p = malloc(n);
  // ... 复杂逻辑提前 return 分支没 free
  // ✅ RAII 兜底
  std::unique_ptr<void, void(*)(void*)> guard(p, free);
  // ...
}

修完后再录一轮 Allocation，会发现 Created & Existing 下降、Created & Released 增加，曲线回到健康水平。(华为开发者官网)

---

八、FAQ：几个“坑里躺过”的问题

• Q1：为什么线上（已上架）抓不到某些泳道？
  A：出于隐私安全策略，部分 Allocation/Native Allocation 录制对上架应用禁用；请在 Debug 包 / 内测环境中录制。(华为开发者官网)

• Q2：Snapshot 与 Allocation 该先用谁？
  A：先 Allocation 看“谁在涨”、再 Snapshot “看谁没走 + 为何走不了”。两者互补，一个看时间维度，一个看对象图。(掘金)

• Q3：怎么把设备堆快照拉回本地分析？
  A：拿到 .rawheap 后用 rawheap_translator 转 .heapsnapshot，DevEco/Chrome 都能打开。(GitCode)

• Q4：系统层快速看内存有没有飙？
  A：hdc shell hidumper --mem [pid] 一把梭；要批量/留档，加 --zip 并拉回本地。(华为开发者官网)

---

结语：

内存优化最怕“拍脑袋”，最爱“有证据”。趋势（Memory）→ 分配（Allocation）→ 快照（Heap）→ 复现和回归，这条流水线一走通，泄漏就不再是玄学。下次当曲线又悄悄上扬，记得问自己一句：“它为什么不走？” —— 然后，打开 Profiler，把证据一条条拽出来。😉

---

参考与延伸

• DevEco Profiler 内存定位思路（Snapshot / Allocation 模板、ArkTS & Native 分析）。(华为开发者官网)
• Snapshot Insight：堆快照分析（Heap Analyzer 思路），用于对比不同时刻对象与保留大小。(掘金)
• rawheap_translator 工具：.rawheap → .heapsnapshot，可导入 DevEco 或 Chrome DevTools。(GitCode)
• HiDumper：--mem 等系统级内存导出，便于基线巡检/回归比对。(华为开发者官网)
• ASan/HWASan 在 DevEco 的使用与约束（互斥、配置 ASAN_OPTIONS 等）。(华为开发者官网)

想不想我把“一键体检 + Profiler 录制 + 快照对比 + 报告导出”这套流程整理成团队内通用 SOP 清单（含命令与截图位）？告诉我你的项目形态（纯 ArkTS / 混 NAPI），我直接给你一版可落地的模板清单和用例脚本 🤝

…

(未完待续)