HarmonyOS 7 组件标了 ReusableV2切换父组件却还在重建全局复用池要放对位置页面在“列表/卡片”两种区域间来回切换同一张复杂卡片已经写了ReusableV2日志却总是出现新实例创建。问题不一定是装饰器失效默认复用池跟着直接父组件走。父组件整体离开组件树时它自己的池也随之消失另一个父组件拿不到这批回收实例。API 26 新增的全局复用池正是处理跨父组件复用的工具但它不是“打开就一定更省内存”的开关。下面用同一张ReusableTile在两个面板之间切换。先看默认池再把池放到切换期间一直存在的上层组件。共用的可复用组件先定义子组件再定义使用它的父组件。这个顺序不是排版习惯官方特别提醒写入poolAccepts的组件必须在使用它的装饰器之前完成声明或导入否则可能触发Class ... used before its declaration。ReusableV2 ComponentV2 struct ReusableTile { Param label: string ; aboutToAppear(): void { console.info(tile ${this.label}: appear); } aboutToReuse(): void { console.info(tile ${this.label}: reuse); } aboutToRecycle(): void { console.info(tile ${this.label}: recycle); } build() { Row() { Text(this.label).fontSize(18) } .height(96) .width(100%) .backgroundColor(#E9F2EF) } } ComponentV2 struct ListPanel { build() { Column() { ReusableTile({ label: 列表卡片 }) } } } ComponentV2 struct DetailPanel { build() { Column() { ReusableTile({ label: 详情卡片 }) } } }案例一只有子组件可复用切换面板仍重新创建这个页面只给ReusableTile加了复用装饰器没有给持续存在的上层组件配置池。连续点击切换按钮观察appear、recycle与reuse的日志不要只凭肉眼觉得“切换变快了”。Entry ComponentV2 struct BaselinePage { Local showList: boolean true; build() { Column({ space: 12 }) { Button(切换列表/详情) .onClick(() { this.showList !this.showList; }) if (this.showList) { ListPanel() } else { DetailPanel() } } } }切换时ListPanel与DetailPanel是不同的父组件实例。默认复用池归各自父组件持有一个面板被移除后其池不能直接供另一个面板取用。这是“写了ReusableV2却看不到跨面板复用”的原因不要把aboutToAppear的出现直接解释成框架从未启用复用。案例二在稳定的上层节点接纳这张卡片把池放在切换时不会被销毁的PoolOwnerPage上并声明它接纳ReusableTile。这里选perInstance当前页面每个实例拥有自己的池不把不同页面实例的卡片混在一起。Entry ComponentV2({ reusePool: perInstance, poolAccepts: [ReusableTile], freezeWhenInactive: false }) struct PoolOwnerPage { Local showList: boolean true; build() { Column({ space: 12 }) { Button(切换列表/详情) .onClick(() { this.showList !this.showList; }) if (this.showList) { ListPanel() } else { DetailPanel() } } } }这段配置的重点不是“池越高越好”而是池的拥有者要在两个子面板切换期间保持存活。框架回收或获取ReusableTile时会向上寻找接纳该类型的全局池才能让不同父面板有机会共用同一批回收实例。实际日志时序会受到渲染时机影响应看多次切换后的reuse记录与组件创建次数而不是假定每次点击后立刻打印完全固定的顺序。为什么不直接选 sharedperInstance和shared解决的是不同的池拥有权前者随单个拥有组件实例释放后者可由同一拥有组件类的多个实例共享只要其中还有实例存活池可能继续存在。shared对跨实例复用有价值却也更需要控制缓存量。官方提供getReusableInfo查看池内count通过maxCount设上限把上限调低后清理是异步的短时间里count仍可能高于新上限。观察到的现象优先检查不该先做什么两个父面板间不复用池的拥有者是否在切换时存活继续在子卡片上叠加装饰器编译报装饰器参数错误reusePool、poolAccepts、freezeWhenInactive是否配齐把poolAccepts传空数组编译报先使用后声明可复用组件是否定义在拥有者之前忽略编译错误继续统计性能内存不降反升shared池的存活范围、count/maxCount宣称复用必然节省内存验证建议在 API 26 工程中分别运行两页记录同样的切换次数、appear/recycle/reuse日志和组件创建次数然后比较首次进入、来回切换、退出页面三个阶段。发布性能结论前还要在目标设备上记录帧耗时和内存变化。本文的 API 限制、池查找方向和生命周期说明依据华为 2026-08-29 更新的指南这些页面代码尚未在当前环境完成 API 26 SDK 编译和真机测量因此这里只给出可复现步骤不伪造提速百分比。官方依据全局复用集中化的组件回收与复用。
HarmonyOS 7 组件标了 ReusableV2切换父组件却还在重建全局复用池要放对位置页面在“列表/卡片”两种区域间来回切换同一张复杂卡片已经写了ReusableV2日志却总是出现新实例创建。问题不一定是装饰器失效默认复用池跟着直接父组件走。父组件整体离开组件树时它自己的池也随之消失另一个父组件拿不到这批回收实例。API 26 新增的全局复用池正是处理跨父组件复用的工具但它不是“打开就一定更省内存”的开关。下面用同一张ReusableTile在两个面板之间切换。先看默认池再把池放到切换期间一直存在的上层组件。共用的可复用组件先定义子组件再定义使用它的父组件。这个顺序不是排版习惯官方特别提醒写入poolAccepts的组件必须在使用它的装饰器之前完成声明或导入否则可能触发Class ... used before its declaration。ReusableV2 ComponentV2 struct ReusableTile { Param label: string ; aboutToAppear(): void { console.info(tile ${this.label}: appear); } aboutToReuse(): void { console.info(tile ${this.label}: reuse); } aboutToRecycle(): void { console.info(tile ${this.label}: recycle); } build() { Row() { Text(this.label).fontSize(18) } .height(96) .width(100%) .backgroundColor(#E9F2EF) } } ComponentV2 struct ListPanel { build() { Column() { ReusableTile({ label: 列表卡片 }) } } } ComponentV2 struct DetailPanel { build() { Column() { ReusableTile({ label: 详情卡片 }) } } }案例一只有子组件可复用切换面板仍重新创建这个页面只给ReusableTile加了复用装饰器没有给持续存在的上层组件配置池。连续点击切换按钮观察appear、recycle与reuse的日志不要只凭肉眼觉得“切换变快了”。Entry ComponentV2 struct BaselinePage { Local showList: boolean true; build() { Column({ space: 12 }) { Button(切换列表/详情) .onClick(() { this.showList !this.showList; }) if (this.showList) { ListPanel() } else { DetailPanel() } } } }切换时ListPanel与DetailPanel是不同的父组件实例。默认复用池归各自父组件持有一个面板被移除后其池不能直接供另一个面板取用。这是“写了ReusableV2却看不到跨面板复用”的原因不要把aboutToAppear的出现直接解释成框架从未启用复用。案例二在稳定的上层节点接纳这张卡片把池放在切换时不会被销毁的PoolOwnerPage上并声明它接纳ReusableTile。这里选perInstance当前页面每个实例拥有自己的池不把不同页面实例的卡片混在一起。Entry ComponentV2({ reusePool: perInstance, poolAccepts: [ReusableTile], freezeWhenInactive: false }) struct PoolOwnerPage { Local showList: boolean true; build() { Column({ space: 12 }) { Button(切换列表/详情) .onClick(() { this.showList !this.showList; }) if (this.showList) { ListPanel() } else { DetailPanel() } } } }这段配置的重点不是“池越高越好”而是池的拥有者要在两个子面板切换期间保持存活。框架回收或获取ReusableTile时会向上寻找接纳该类型的全局池才能让不同父面板有机会共用同一批回收实例。实际日志时序会受到渲染时机影响应看多次切换后的reuse记录与组件创建次数而不是假定每次点击后立刻打印完全固定的顺序。为什么不直接选 sharedperInstance和shared解决的是不同的池拥有权前者随单个拥有组件实例释放后者可由同一拥有组件类的多个实例共享只要其中还有实例存活池可能继续存在。shared对跨实例复用有价值却也更需要控制缓存量。官方提供getReusableInfo查看池内count通过maxCount设上限把上限调低后清理是异步的短时间里count仍可能高于新上限。观察到的现象优先检查不该先做什么两个父面板间不复用池的拥有者是否在切换时存活继续在子卡片上叠加装饰器编译报装饰器参数错误reusePool、poolAccepts、freezeWhenInactive是否配齐把poolAccepts传空数组编译报先使用后声明可复用组件是否定义在拥有者之前忽略编译错误继续统计性能内存不降反升shared池的存活范围、count/maxCount宣称复用必然节省内存验证建议在 API 26 工程中分别运行两页记录同样的切换次数、appear/recycle/reuse日志和组件创建次数然后比较首次进入、来回切换、退出页面三个阶段。发布性能结论前还要在目标设备上记录帧耗时和内存变化。本文的 API 限制、池查找方向和生命周期说明依据华为 2026-08-29 更新的指南这些页面代码尚未在当前环境完成 API 26 SDK 编译和真机测量因此这里只给出可复现步骤不伪造提速百分比。官方依据全局复用集中化的组件回收与复用。
