文件命名约定

文件命名约定

基于文件的路由要求您遵循一些简单的文件命名约定，以确保正确生成路由。这些约定启用的概念在路由树 & 嵌套指南中详细介绍。

功能	描述
__root.tsx	根路由文件必须命名为 __root.tsx，并且必须放置在配置的 routesDirectory 的根目录中。
. 分隔符	路由可以使用 . 字符来表示嵌套路由。例如，blog.post 将生成为 blog 的子路由。
$ 令牌	带有 $ 令牌的路由段是参数化的，并将从 URL 路径名中提取值作为路由 param。
_ 前缀	带有 _ 前缀的路由段被认为是无路径布局路由，并且在将其子路由与 URL 路径名匹配时不会使用。
_ 后缀	带有 _ 后缀的路由段将路由从嵌套在任何父路由下排除。
(folder) 文件夹名称模式	与此模式匹配的文件夹被视为路由组，防止该文件夹包含在路由的 URL 路径中。
index 令牌	以 index 令牌（在任何文件扩展名之前）结尾的路由段将在 URL 路径名与父路由完全匹配时匹配父路由。这可以通过 indexToken 配置选项进行配置，请参阅选项。
.route.tsx 文件类型	当使用目录组织路由时，route 后缀可用于在目录路径创建路由文件。例如，blog.post.route.tsx 或 blog/post/route.tsx 可以用作 /blog/post 路由的路由文件。这可以通过 routeToken 配置选项进行配置，请参阅选项。

💡 记住： 项目的文件命名约定可能会受到配置的选项的影响。

动态路径参数

动态路径参数可以在平面路由和目录路由中使用，以创建可以匹配 URL 路径的动态段的路由。动态路径参数由文件名中的 $ 字符表示

文件名	路由路径	组件输出
...	...	...
ʦ posts.$postId.tsx	/posts/$postId	<Root><Posts><Post>

我们将在路径参数指南中了解更多关于动态路径参数的信息。

无路径路由使用逻辑或组件包装子路由，而无需 URL 路径。非路径路由由文件名中的 _ 字符表示

要了解更多关于无路径路由的信息，请参阅路由概念 - 无路径路由指南。