name 是路由的唯一标识符，用于反向解析url，必须全局唯一、合法命名（仅字母数字下划线点号）、不可动态生成；django推荐path+转换器，vue router要求name为字符串字面量，react router v6.4+用id替代name功能。
为什么 name 参数在 Route 里不能随便写
路由名称不是标签或注释，它是生成 URL 的唯一键。Django、Laravel、Vue Router、React Router v6+ 都依赖它做反向解析——比如 url_for('user_profile', id=123) 或 router.push({ name: 'post', params: { id: 'abc' } })。一旦重名、拼错、含非法字符（空格、斜杠、中文），运行时就报错或静默失效。
常见错误现象：NoReverseMatch（Django）、Named route 'xxx' does not exist（Vue Router）、useNavigate 跳转失败但无提示（React Router）。
- 名称必须全局唯一，不同 app 或模块间也要避免冲突
- 只允许字母、数字、下划线、点号（
.），推荐用小写字母 + 下划线风格（如admin_dashboard） - 不要带动态段占位符（比如别写成
user_detail_<code>id，直接叫user_detail就行） - 嵌套路由建议用点号分隔层级，如
blog.list、blog.detail，便于组织和条件查找
Django 中 path 和 re_path 设置 name 的区别
两者都支持 name 参数，但底层匹配逻辑不同，影响 URL 反向生成的稳定性。
path 是推荐方式，转换器（如 int:、slug:）会自动处理类型校验；re_path 用正则，参数需手动命名捕获组（(?P<id>\d+)</id>），否则 reverse 时无法传参。
-
path('user/<code>int:id/', views.user_view, name='user_detail') → 可直接reverse('user_detail', kwargs={'id': 123}) -
re_path(r'^user/(?P<id>\d+)/$', views.user_view, name='user_detail')</id>→ 必须用kwargs且 key 名和正则中?P<id></id>严格一致 - 如果用
re_path(r'^user/(\d+)/$', ...)（未命名组），reverse会报TypeError: reverse() takes exactly 2 arguments
Vue Router 4 的 name 必须是字符串字面量，不能是变量或计算值
很多人想动态生成路由名来适配多语言或租户场景，但 name 字段在路由定义阶段就被注册进全局 registry，运行时修改无效，且构建时会被静态分析——所以它必须是确定的字符串。
常见错误现象：用 name: `${prefix}_list` 导致 router.resolve({ name: 'xxx_list' }) 返回空对象；或热更新后路由名丢失。
- 所有
name写死在routes数组里，哪怕有几十个也别拼接 - 需要逻辑复用？抽成函数返回完整路由对象，但
name仍为常量字符串 - 动态前缀（如
/tenant-a/）应通过children+path实现，而非靠name区分
React Router v6.4+ 的 createRoutesFromElements 怎么保留 id 作为路由别名
v6.4 引入了新 API，element 写法不再显式暴露 name，但内部仍靠 id 字段支撑 useNavigate 和 useParams 的路径推导。这个 id 就是事实上的路由别名。
如果你之前习惯 Django 的 url_name，现在得把思维切换到「路由树节点 ID」——它不用于模板渲染，但决定导航时的路径匹配精度和 loader 数据流。
-
<route id="product-detail" path="products/:id" element="{<ProductPage"></route>} />→ 后续可navigate({ id: 'product-detail', params: { id: '789' } }) -
id必须唯一，且不能含斜杠；推荐与文件结构对齐，如app.routes.product.detail - 没写
id的路由，系统会自动生成一个，但不可控，不利于测试和调试
