页面与路由

扫描范围

项	规则
根目录	仅 src/pages/
扩展名	.tsx、.jsx
首页	必须存在 index.tsx / index.jsx → /
不扫描	src/.selrux/、其它扩展名

URL 映射

文件	URL
pages/index.tsx	/
pages/about.tsx	/about
pages/users/index.tsx	/users
pages/users/[id].tsx	/users/$id
pages/users/[id]/edit.tsx	/users/$id/edit

• 静态段：小写字母、数字、连字符。
• 动态段：仅 [param]，生成 $param。
• 路径任一片段以 _ 开头：不注册为路由。
• 文件名含 .（如 foo.bar.tsx）：报错。

冲突

同 URL 多文件、非法段名、缺失首页，在 generate / dev / build 时明确失败。

不支持

可选 catch-all、路由组 (group)、并行路由、运行时下发路由。

页面内链接与参数读取使用 TanStack Router 公开 API（如 Link、useParams）。

启用 shell: true 时，configureShellRouteMeta 使用上表 URL 模式 作键（如 /users/$id），实例路径 /users/42 只影响页签身份与动态标题。详见 shell/config。