适用版本

• HarmonyOS 5
• DevEco Studio 5.x / 6.x
• ArkTS
• Stage模型
• 真机、模拟器均支持

前言

对于HarmonyOS开发来说，最大的痛点之一就是编译速度。

尤其项目越来越大以后：

• 编译一次30秒
• 大项目甚至1分钟以上
• 修改一个padding
• 修改一个字体颜色
• 修改一个Text文本

却仍然需要：

Build ↓ Install ↓ Launch ↓ 进入页面

开发效率极低。

HarmonyOS 5 官方提供了Hot Reload（热更新）与增强能力Hot Restart（热重启），能够在大量代码修改场景下避免完整重新编译，大幅提升调试效率。对于资源文件、C++ 等部分修改，较新的 DevEco Studio 还提供了Apply Changes能力。

本文将从原理、配置、使用、限制、最佳实践到常见问题，全面讲解 DevEco Studio 热更新调试模式。

一、什么是Hot Reload？

什么是热更新

Hot Reload（热更新）：

修改代码后，不重新安装APP。

只更新：

修改的代码

然后重新加载页面。

整个过程通常只需数秒。

相比：

重新编译 ↓ 重新安装 ↓ 重新启动APP

效率提升十分明显。官方介绍指出，在不同规模的 ArkTS 项目中，Hot Reload 相比全量构建可带来明显的调试效率提升。

二、Hot Reload工作原理

主要分为两个阶段：

修改代码 ↓ 增量编译 ↓ 生成Patch ↓ 发送到设备 ↓ 替换运行代码 ↓ 刷新页面

整个过程中：

不用重新安装APP。

三、Hot Reload 与 Hot Restart 的区别

从 DevEco Studio 5.1.1 Beta1 起，可开启Enable hot restart，当遇到 Hot Reload 不支持的修改时，IDE 会自动切换到 Hot Restart。

四、哪些修改支持热更新？

支持：

• Text内容
• Button
• Row
• Column
• Flex
• Stack
• Grid
• 字体
• Padding
• Margin
• Background
• Color
• Border
• Radius
• Visibility
• Opacity
• 大部分ArkUI组件

通常不支持：

• 新增资源文件
• C++代码
• Native层修改
• 部分初始化逻辑
• 全局状态初始化
• Ability 生命周期相关代码

对于资源文件和 C++ 的增量调试，在较新的 DevEco Studio 中可以结合Apply Changes使用（需 IDE 和设备版本满足要求）。

五、开启Hot Reload前的准备

需要：

• DevEco Studio
• HarmonyOS SDK
• 模拟器或真机
• Debug模式

六、开启热更新模式

第一步：切换运行配置

打开：

Run Configurations

或者：

Edit Configurations

找到：

entry

切换到：

entry(H)

即带H标识的运行配置（Hot Reload）。

七、启动应用

点击：

Run

或者：

Debug

启动后：

工具栏会出现：

H

按钮。

说明：

Hot Reload模式已开启

八、第一次热更新

例如修改：

Text("Hello")

改成：

Text("HarmonyOS")

点击：

H

即可进行：

Hot Reload

无需重新安装。

九、开启Ctrl+S自动热更新

推荐配置：

File ↓ Settings ↓ Tools ↓ Actions on Save

勾选：

Perform Hot Reload

保存后：

Ctrl + S

即可自动执行 Hot Reload，无需再点击 H 按钮。

十、Hot Restart配置

打开：

Settings ↓ Build, Execution, Deployment ↓ Hot Reload

勾选：

Enable Hot Restart

遇到无法热更新的场景时：

IDE 自动：

Hot Restart

无需手动切换。

十一、Apply Changes配置（DevEco Studio新版本）

如果：

资源文件

或者：

C++

修改较多。

可以开启：

Enable Apply Changes

这样：

Hot Reload ↓ Hot Restart ↓ Apply Changes

IDE 会自动选择最合适的方式完成增量调试。

十二、真机调试

推荐：

USB连接 ↓ HDC连接 ↓ Debug模式

首次部署后：

以后：

Ctrl+S ↓ 自动Hot Reload

几秒钟即可看到效果。

十三、模拟器调试

模拟器同样支持：

• Hot Reload
• Hot Restart
• Apply Changes（满足条件时）

操作流程与真机基本一致。

十四、Hot Reload支持哪些ArkUI组件？

几乎所有常见组件：

• Text
• Image
• Button
• TextInput
• Scroll
• List
• Grid
• Tabs
• Navigation
• NavDestination
• Column
• Row
• Stack
• Flex
• RelativeContainer

十五、哪些修改不会立即生效？

例如：

globalThis.xxx

或者：

AppStorage

初始化。

这些通常需要：

Hot Restart

甚至：

重新运行

十六、常见问题排查

1. 看不到 H 图标

检查：

• 是否选择entry(H)配置
• 是否使用 Debug 模式
• IDE 是否支持 Hot Reload

2. Ctrl+S 没反应

确认：

Tools ↓ Actions on Save ↓ Perform Hot Reload

已开启。

3. 修改资源文件无效

尝试：

• Apply Changes
• Hot Restart
• Run Again

十七、性能对比

十八、最佳实践

推荐开发流程：

1. 使用entry(H)运行。
2. 开启Enable Hot Restart。
3. 配置Perform Hot Reload，保存即生效。
4. 在支持条件下开启Apply Changes。
5. 大部分 UI 调整依赖 Hot Reload，仅在涉及初始化、资源或底层修改时再选择 Hot Restart 或重新运行。

总结

HarmonyOS 5 的热更新调试能力可以显著减少重复编译与安装的时间，让开发者专注于业务逻辑和界面开发。熟练使用Hot Reload、Hot Restart以及Apply Changes，配合Ctrl+S 自动热更新，能够有效提升日常开发效率。

如果目标是撰写一篇约 2 万字的深度教程，建议在上述框架基础上进一步补充：

• Hot Reload 内部工作机制与增量编译原理
• ArkUI 状态管理与热更新关系（@State、@Observed、@ObjectLink 等）
• 真机与模拟器完整配置截图
• 典型项目实战案例
• 常见报错与排查指南
• DevEco Studio 不同版本（5.x/6.x）功能差异分析
• 企业级项目中的热更新开发规范与最佳实践