本文档详细介绍如何使用 DevEco Studio 自带的预览器（Previewer）快速查看 main-ets-pages 目录下的 .ets 文件 UI 效果，涵盖页面预览、组件预览、进阶技巧及常见问题排查等内容，帮助开发者提升 UI 开发效率。
该方法适合查看完整页面的交互效果和整体布局，是开发过程中最常用的预览方式。
确保需要预览的 .ets 页面中，页面入口 struct 上方已添加 @Entry 装饰器，该装饰器标识当前组件为页面入口，是预览器识别完整页面的必要条件。
1. 在项目目录中依次进入 src > main > ets > pages，双击打开目标 .ets 页面文件。
2. 点击编辑器右上角的 Previewer 标签，预览器会自动启动并加载当前页面的 UI 效果。
3. 预览器启动后，可直接在预览窗口中模拟真机操作，通过点击页面按钮、列表项等元素，结合应用内路由功能（如 router.pushUrl()）实现多页面切换预览。
4. 修改页面代码后，按下 Ctrl + S 保存文件，预览器会自动触发热加载（Hot Reload），无需重启即可显示最新代码效果。
该方法适合在不启动完整页面的情况下，精细化调试单个组件（如自定义按钮、卡片组件）的样式和布局。
1. 在目标 .ets 文件中，找到需要预览的组件 struct，在其上方添加 @Preview 装饰器。
2. 点击编辑器右上角的 Previewer 图标，预览器将仅渲染被 @Preview 装饰的组件，不会加载页面其他内容。
3. 同一个 .ets 文件中最多可添加 10 个 @Preview 装饰器，预览器会同时展示所有被装饰的组件，方便多组件样式对比。
两种预览方式适用于不同开发场景，核心特性对比如下：
在 Previewer 窗口中，打开 Profile Manager 中的 Multi-profile preview 开关，可同时查看最多4个不同设备（手机、折叠屏、平板、智能穿戴）上的UI效果，大幅提升多设备适配测试效率。
打开目标 .ets 文件后，点击编辑器右上角的 ArkUI Editor 按钮，可进入可视化拖拽编辑模式。在画布上直接拖拽组件或修改属性参数，代码会自动同步更新，适合快速搭建页面原型。
点击 Previewer 窗口顶部的 Inspector 图标（瞄准器样式），即可开启双向预览功能。此时在预览器中点击任意UI元素，编辑器会自动高亮定位到对应的代码行；反之在编辑器中选中代码，预览器也会高亮对应的UI组件。
问题1：预览器未显示或修改代码后不刷新
解决方案：点击预览窗口右上角的刷新按钮，或通过菜单栏 Build > Clean Project 清理项目缓存后重新构建。
问题2：预览页面黑屏或加载报错
解决方案：① 检查代码中引用的API是否在预览器支持列表内；② 确认 src/main/resources/base/profile/main_pages.json 文件中已包含当前页面的路径配置。
问题3：引用HSP（HarmonyOS Shared Package）时报错
解决方案：预览器暂不支持直接预览依赖HSP的页面，可进入HSP模块内部，直接预览模块内的独立组件。
文档版本：V1.0 | 更新日期：2024年4月
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。