核心差异在于底层机制和浏览器行为触发点:createWebHistory基于History API操作历史栈并触发服务器请求,需服务端配合;createWebHashHistory基于hash变更,不发服务器请求,兼容性更好且无需服务端配置。

核心差异不在代码长度,而在底层机制和浏览器行为触发点。两者都返回 RouterHistory 实例,但内部监听、URL 解析和导航响应方式完全不同。
createWebHistory 依赖原生 History API
它调用 history.pushState() 和 history.replaceState() 修改地址栏路径,同时监听 popstate 事件捕获前进/后退动作。URL 变化不带 #,浏览器会向服务器发起真实请求(如访问 /about 就发 GET /about 请求)。
- 初始化时检查
window.history是否可用,不可用则抛错 - 路由跳转本质是操作浏览器历史栈,不修改
location.hash - 刷新页面时,服务器必须返回
index.html,否则直接 404 - 支持
scrollBehavior和navigation guards的完整生命周期
createWebHashHistory 依赖 URL hash 变更
它通过设置 location.hash 改变 URL,并监听 hashchange 事件响应跳转。所有路由路径都拼在 # 后面,这部分内容不会被发送到服务器。
- 初始化时自动补全缺失的
#(比如访问根路径时设为#/) - 每次跳转实际执行的是
location.hash = '#/xxx' - 刷新或直接访问
https://site.com/#/admin,服务器只收到GET /请求,始终能返回首页 - 兼容 IE9+,无需任何服务端配置
关键方法签名与行为对比
虽然对外都提供 push()、replace()、go() 等方法,但内部实现逻辑不同:
-
push({ path: '/user' })在createWebHistory中调用history.pushState();在createWebHashHistory中等价于location.hash = '#/user' -
go(-1)都触发浏览器原生前进/后退,但createWebHistory依赖popstate事件还原状态,createWebHashHistory则靠hashchange读取新 hash 值 -
createWebHistory可携带state对象(用于跨跳转传参),createWebHashHistory不支持该能力
Vue Router 初始化时的路径解析逻辑不同
两者从 URL 提取当前路由路径的方式有根本区别:
-
createWebHistory直接取location.pathname + location.search + location.hash中的路径部分(忽略 hash) -
createWebHashHistory先截取location.hash,再去除开头的#,最后解析剩余字符串为路径 - 这意味着
https://a.com/path?k=v#/user?id=1:前者匹配/path,后者匹配/user










