屏幕采集（OH_AVScreenCapture）在做录屏、直播、协同标注类应用时是刚需。开发者常遇到一个困惑：「我采集了整个屏幕，为什么软键盘的候选词/悬浮窗不在画面里？能不能把它也采进去？」这涉及 HarmonyOS 的窗口采集范围与隐私窗口排除策略。本文给出配置代码，并讲清哪些窗口能采、哪些被系统强制排除。

关于 TaskPool，社区里流传一个常见误解：「LongTask 和 taskpool.execute 是系统里的两套调度队列，长任务走 A 队列、短任务走 B 队列」。这个理解不对，也是很多人写出「长任务被饿死 / 短任务迟迟不执行」代码的病因。本文依据 HarmonyOS 并发模型讲清二者在调度器里的真实关系，并给出选型代码。

元服务（原原子化服务）的桌面卡片是用户获取信息的第一入口，很多开发者反馈「FormExtensionAbility 配置了定时刷新，但卡片内容半天不更新」。这个现象背后并不是某一个 API 失效，而是 HarmonyOS 的卡片刷新机制由刷新方式、卡片可见性、应用冻结状态、最小刷新周期四重约束共同决定。本文结合实际踩坑，给出一套可落地的排查清单与可运行代码。

HarmonyOS 的 ArkTS 采用线程隔离模型：UI 主线程、TaskPool 工作线程、Worker 各自独立，普通的对象实例不能跨线程传递。很多开发者第一次用 taskpool.execute 把对象当参数传进去，直接报错"object is not sendable"。本文基于论坛问题「ArkTS 里 @Sendable 类和普通 class 在 ArkCompil

状态管理是 ArkUI 开发的地基。很多开发者分不清 @State 和 @Observed 的边界，结果"对象里的字段改了界面不刷新"，或"为了一个嵌套属性把整个对象都标记响应式"导致性能浪费。本文基于论坛问题「@State 与 @Observed 在状态管理上该如何」，把二者的职责边界和组合用法讲透。

鸿蒙的分布式数据管理能力（DistributedKVStore）能让同一华为账号下的多设备共享轻量键值数据，是"手机改了设置、平板自动生效"这类体验的核心。但很多开发者第一次用就遇到"同步失败"。本文基于论坛问题「分布式数据管理 Preferences 跨设备同步失败」，把前置条件和正确写法一次讲清。

鸿蒙的分布式数据管理能力（DistributedKVStore）能让同一华为账号下的多设备共享轻量键值数据，是"手机改了设置、平板自动生效"这类体验的核心。但很多开发者第一次用就遇到"同步失败"。本文基于论坛问题「分布式数据管理 Preferences 跨设备同步失败」，把前置条件和正确写法一次讲清。

深色模式不是简单地"把背景涂黑"，它涉及颜色资源的体系化管理、系统色彩模式的监听、以及应用内手动切换的覆盖逻辑。本文基于论坛问题「HarmonyOS 应用如何优雅地做深色模式适配」，给出一套零硬编码、可维护的适配方案，让浅/深两套配色自动切换，同时支持用户手动覆盖。

在 HarmonyOS 应用里，列表是最常见也最容易卡顿的界面。很多开发者一上来用 ForEach 把成百上千条数据一次性塞进 List，结果首屏白屏、滑动掉帧、内存飙升。本文基于华为开发者论坛的真实问题「ArkUI 自定义组件如何实现高性能的列表懒加载与复用」，系统讲解 LazyForEach + cachedCount + @Reusable 这套官方高性能组合，并给出可运

当工程从「单 Module Demo」长成「多业务线的大型 App」，把所有代码塞进一个 entry 会让编译变慢、耦合爆炸。HarmonyOS 提供两种可复用包：HAR（HarmonyOS Archive，静态共享包） 与 HSP（HarmonyOS Shared Package，动态共享包）。本文讲清楚两者差异、何时用哪个，以及如何跨包共享资源与代码。