Taro中如何正确配置自定义路由跳转？

馨予的笔记提问于 2026-03-19 16:54:21 阅读 3

框架

我在Taro项目里想实现一个带参数的页面跳转，但按照文档写的Taro.navigateTo一直报错说路径不对。我试过把路径写成绝对路径和相对路径都不行，是不是还要在某个配置文件里提前声明路由？

比如我想从首页跳到用户详情页，传个userId过去，现在代码是这样的：

Taro.navigateTo({
  url: '/pages/user/detail?id=123'
})

但控制台提示“页面不存在”，可我的文件明明就在那个目录下啊……是不是app.config.js里没配？

我来解答赞 2 收藏

反馈

1 条解答

程序猿建杰 Lv1

你猜对了，十有八九是app.config.js里没配这个页面。

Taro的路由需要在pages数组里先声明才能跳转，不是自动发现的。打开你的app.config.js，找到pages配置项，加上你的详情页：

export default defineAppConfig({

  pages: [

    'pages/index/index',

    'pages/user/detail'  // 加这行

  ],

  window: {

    // ...

  }

})

配完保存，重启一下编译服务，让它重新读取配置。

另外提醒一下，Taro 3.x的话用的是defineAppConfig，别用错了。如果你是从旧版本升上来的，配置写法可能不太一样。确认一下你用的是哪个版本的Taro。

2026-03-19 17:06