# 运行
HBuilder V 内置了 uni-app x 的运行能力，可以把项目运行到 Chrome、Android/iOS App 基座、鸿蒙设备或小程序开发者工具，并在 运行控制台 中查看编译和运行日志。
运行的核心价值是 热刷新：代码修改后自动同步到运行端，无需重新打包即可实时看到效果，同时可以在编辑器中直接查看 console.log 输出。
运行需要相关插件的支持，如果尚未安装，会弹窗提示安装插件。
# 运行入口
- 运行菜单：菜单栏中的 运行 菜单会列出当前项目可用的运行目标，不支持的平台不会显示。
- 标题栏运行按钮：点击标题栏搜索框右侧的运行图标，在弹出的菜单中选择运行目标；菜单内容会根据当前项目类型动态筛选。
多项目工作区中，HBuilder V 会优先使用当前活动文件所在的项目；无法判断项目时会弹出项目选择器。
如果运行菜单中没有目标项，请确认当前打开的文件属于 uni-app x 项目。
# 支持的运行目标
| 运行目标 | 说明 |
|---|---|
| 运行到Chrome | Chrome、Edge |
| 运行到Android App基座 | Android 真机或模拟器，支持标准基座与自定义基座 |
| 运行到iOS App基座 | iPhone / iPad 真机 |
| 运行到鸿蒙 | HarmonyOS 设备与模拟器 |
| 微信开发者工具 | 微信小程序 |
| 支付宝小程序开发者工具 | 支付宝小程序 |
# 运行控制台
运行项目时会打开 运行控制台，可以：
- 查看编译过程、警告与错误信息；
- 查看
console.log等运行时日志，点击日志可跳转到对应代码； - 使用控制台工具栏的 重新运行、停止、清空 等操作；
- 在支持的平台上切换运行时日志显示；
- 在控制台工具栏点击调试图标 开启调试，对 uni-app x 项目进行断点调试，详见 调试。
运行失败时，优先查看运行控制台中的第一条错误信息；编译错误通常会指明具体的文件与行号。
# 页面筛选
多页面项目中，页面筛选 可以临时屏蔽不需要调试的页面：运行和编译时只保留选中的页面，缩短编译与同步耗时。
# 使用步骤
- 打开项目的
pages.json； - 把光标放在要保留的页面配置上；需要保留多个页面时，可以按住
Alt（macOS 为⌥）多选，或框选多个页面； - 在
pages.json编辑器中右键选择 页面筛选，或在命令面板（Ctrl+Shift+P，macOS 为⇧⌘P）中执行 页面筛选。
执行后 pages.json 会被自动改写并保存：
- 原来的
pages重命名为-pages保留，新增的pages只包含所选页面； subPackages会被临时屏蔽（重命名为-subPackages，新subPackages为空）。
需要恢复全部页面时，在 pages.json 中执行 取消页面筛选：-pages、-subPackages 会还原为 pages、subPackages。
两个命令都要求
pages.json是当前编辑器；光标不在页面配置上时会提示"请将光标放在要保留的页面配置上"。
# 常见问题
- 运行菜单里没有目标项：确认当前打开的文件属于 uni-app x 项目。
- 首次运行较慢：首次运行需要下载基座或编译依赖，可以清理缓存后重试。
- 修改代码后没有热刷新：确认运行进程未停止；App 端原生层修改无法热刷新，需要重新运行或制作自定义基座。
更多问题见 常见问题。
