Vue Router 严格路径匹配需设 sensitive: true(区分大小写)和 strict: true(末尾斜杠精确一致),支持全局配置或单路由局部配置,且组件导入路径大小写须与文件系统完全一致。

Vue Router 默认对路径大小写不敏感,且末尾斜杠 / 不影响匹配(即 /user 和 /user/ 被视为相同)。要实现严格的路径匹配——既区分大小写,又要求末尾斜杠精确一致——需通过 sensitive 和 strict 两个布尔配置项控制。
在全局路由实例中启用严格模式
适用于整个应用统一规范的场景。在创建路由实例时传入配置:
-
sensitive: true→ 路径匹配区分大小写(/User≠/user) -
strict: true→ 要求路径末尾斜杠必须显式一致(/admin不再匹配/admin/)
示例:
import { createRouter, createWebHistory } from 'vue-router'
const router = createRouter({
history: createWebHistory(),
routes: [
{ path: '/home', component: () => import('@/views/Home.vue') },
{ path: '/About', component: () => import('@/views/About.vue') } // 注意大写 A
],
sensitive: true, // 启用大小写敏感
strict: true // 启用尾部斜杠严格匹配
})在单条路由中单独配置更灵活
当只需对特定路由启用严格规则(如后台管理路径需区分大小写,而前台页面保持宽松),推荐在 route 配置对象内设置:
- 每个
route可独立声明sensitive和strict - 局部配置优先级高于全局配置,未声明则继承全局值
- 例如:只让
/API区分大小写,但允许/api/和/api都匹配普通接口页
示例:
const routes = [
{
path: '/API',
component: () => import('@/views/ApiDashboard.vue'),
sensitive: true, // 仅此路由区分大小写
strict: true // 且必须是 /API,不能是 /API/
},
{
path: '/user',
component: () => import('@/views/UserList.vue')
// 无 sensitive/strict → 使用全局默认(或不设全局时为 false)
}
]文件系统与路由路径大小写必须一致
即使启用了 sensitive: true,若组件实际路径大小写不匹配,仍会报错(尤其在 Windows/macOS 开发环境可能“侥幸通过”,但部署到 Linux 服务器必失败):
- 确保
import()路径中的目录名、文件名与磁盘实际大小写完全一致 - 例如:组件文件是
src/views/show/Index.vue,路由中就不能写成import('@/views/Show/index.vue') - 驼峰命名(如
UserProfile.vue)和 kebab-case(如user-profile.vue)也需严格对应
配合正则约束提升路径精度
单纯靠 sensitive 和 strict 还不够?可叠加动态参数正则进一步限定格式:
- 例如强制
/order/123中的 ID 必须为数字:path: '/order/:id(\d+)' - 或限制产品名只允许小写字母+短横线:
path: '/product/:slug([a-z]+-[a-z]+)' - 注意 JavaScript 字符串中反斜杠需双写:
\d+才等价于正则中的d+
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










