项目准备与结构搭建

首先，确保你已经在 DevEco Studio 中创建了一个基础的 ArkTS 工程，然后按以下结构创建页面文件：

src/main/ets/pages/

├── Index.ets // 首页（页面1）

└── Second.ets // 跳转目标页（页面2）

分步实现双页面跳转

步骤 1：编写首页（Index.ets） 首页的核心功能是显示页面信息，并提供跳转按钮，点击后跳转到第二个页面。

步骤 2：编写目标页（Second.ets）

目标页的核心功能是显示当前页面信息，并提供返回按钮，点击后回到首页。

步骤 3：修改页面配置文件（关键！）

鸿蒙应用中，所有页面都需要在 main_pages.json 中注册，否则会无法找到页面路径，跳转失败。

打开路径：src/main/resources/base/profile/main_pages.json，修改内容如下：

运行与效果验证

1. 点击 DevEco Studio 右上角的 “运行” 按钮，启动模拟器或连接真机；
2. 应用启动后，默认进入首页（页面 1），显示 “🏠 首页（页面 1）” 和跳转按钮；
3. 点击 “点击跳转到页面 2”，应用会切换到目标页，显示 “📄 目标页（页面 2）” 和返回按钮；
4. 点击 “点击返回首页”，应用会回到初始的首页，跳转流程完成。

常见问题与避坑指南

1. 跳转失败，提示 “找不到页面”

   • 检查 main_pages.json 中是否注册了目标页面；
   • 检查 router.pushUrl 中的 url 路径是否和注册路径完全一致；
   • 检查页面文件是否存在，路径层级是否正确。

2. 点击按钮没反应

   • 检查是否在页面顶部导入了 router 模块；
   • 检查按钮的 onClick 事件是否正确绑定了跳转方法；
   • 检查 DevEco Studio 的控制台，查看是否有报错信息。

3. 页面跳转后无法返回

   • 目标页面必须使用 router.back() 方法返回，不能直接用 pushUrl 跳转回首页（会导致页面栈堆积）；
   • 确保首页在页面栈中，没有被错误关闭。