uniapp reLaunch

### uni-app 中 `reLaunch` 方法使用说明

#### 功能描述
`uni.reLaunch()` 是用于关闭所有页面并打开到应用内指定页面的方法。此操作会使跳转列表被刷新，因此适用于需要重置导航栈的情况[^2]。

#### 参数配置
该函数接受一个对象作为参数，其中主要包含目标路径属性：

- **url**: (String 类型) 需要跳转的目标页面路径, 支持相对路径和绝对路径；如果路径中存在 querystring，则会被自动解析成相应的查询字符串形式传递给目标页。

// 示例代码：调用 reLaunch 进行页面切换
uni.reLaunch({
    url: '/pages/targetPage/targetPage?param=value'
});

#### 常见问题解答

##### tabBar 页面处理
当涉及到带有底部标签栏的应用时，可以直接通过 `reLaunch` 来实现从任意位置回到 tabbar 的某一页而不会保留之前的浏览记录。不过需要注意的是，在某些特定场景下（比如自定义表头含有多个 title），可能还需要额外设置一些参数来确保正确显示所需的内容。

##### 返回逻辑差异
不同于其他如 `navigateBack` 或者简单的 `redirectTo`, 使用 `reLaunch` 后无法再利用硬件返回键或软件按钮返回至上一层界面，因为整个历史堆栈已经被清空替换为了新的单一路由节点[^3].

---

相关问题

uniapp的app 使用reLaunch后无法返回

在uniapp中，使用reLaunch方法可以重定向到指定页面，但是会导致无法返回上一个页面。这是因为reLaunch方法会关闭所有已经打开的页面，然后重新打开指定页面，所以无法返回之前的页面。如果需要返回上一个页面，可以使用uni.navigateBack方法，该方法可以返回到上一个页面。

以下是一个使用uni.navigateBack方法返回上一个页面的例子：

// 在需要返回的页面中，监听返回事件
onBack: function() {
  uni.navigateBack({
    delta: 1 // 返回的页面数，1表示返回上一个页面
  })
}

// 在需要触发返回事件的地方，调用onBack方法
this.onBack()

如何让uniapp小程序项目以最少的代码让每个页面都有uni.reLaunch的效果呢

要让uniapp小程序项目以最少的代码让每个页面都有`uni.reLaunch`的效果，可以按照以下步骤：

1. 在`main.js`文件中添加全局混入：

Vue.mixin({
  methods: {
    reLaunch(url) {
      uni.reLaunch({ url })
    }
  }
})

2. 在需要使用`uni.reLaunch`方法的页面中，直接调用`this.reLaunch(url)`即可：

export default {
  methods: {
    handleClick() {
      this.reLaunch('/pages/home/home')
    }
  }
}

这样，每个页面都可以通过`this.reLaunch(url)`方法来进行页面跳转，并且无需重复编写`uni.reLaunch`的代码，大大提高了开发效率。