vueRouter hash模式和history模式

ds

Vue Router 的 hash 模式 和 history 模式 主要区别如下:


1. URL 表现形式

  • Hash 模式

    URL 中带有 # 符号,例如:
    http://example.com/#/about
    # 后的内容称为哈希值,不会发送到服务器,浏览器会根据hash值的变化来渲染不同的组件

  • History 模式

    URL 无 #,更接近传统路径,例如:
    http://example.com/about

    路径直接作为服务器请求的一部分。


2. 实现原理

  • Hash 模式

    基于浏览器的 hashchange 事件 和 URL 哈希值:

    • 当hash值发生变化时,会触发该事件,Vue Router监听这个事件,根据新的hash值来渲染对应的组件。
    • 由于hash值的变化不会向服务器发送请求,所以在单页面应用中非常方便。
  • History 模式

    基于 HTML5 History API (pushState、replaceState):

    当用户点击链接或者调用路由方法时,Vue Router会调用这些方法来更新浏览器的历史记录,同时渲染对应的组件。


3. 服务器配置

  • Hash 模式

    • 无需服务器特殊配置
    • 服务器仅处理根路径(如 /),# 后的内容由前端解析。
    • 无论用户访问哪个hash值的URL,服务器都会返回单页面应用的HTML文件,然后由前端的Vue Router来处理路由切换。
  • History 模式

    • 需服务器支持
    • 当用户直接访问某个路由或者刷新页面时,浏览器会向服务器发送请求,如果服务器没有正确配置,直接访问子路由会返回 404。
    • 所以需要在服务器端进行配置,让服务器在接收到所有请求时都返回单页面应用的HTML文件,然后由前端的Vue Router来处理路由切换

    需配置服务器将所有路径重定向到入口文件(如 index.html),例如:

    nginx 复制代码
    # Nginx 配置示例
    location / {
      try_files $uri $uri/ /index.html;
    }

4. 兼容性

  • Hash 模式

    兼容所有浏览器(包括 IE8 及以下)。

  • History 模式

    依赖 HTML5 History API,不支持 IE9 及以下。


5. SEO 优化

  • Hash 模式

    哈希内容默认不会被搜索引擎抓取,可能影响 SEO。

  • History 模式

    URL 更友好,易于搜索引擎解析。但需配合服务端渲染(SSR)或预渲染解决动态内容抓取问题。


6. 应用场景

  • Hash 模式适用场景

    • 无需服务器配置的静态站点。
    • 需兼容旧浏览器的项目。
  • History 模式适用场景

    • 追求 URL 美观的现代 Web 应用。
    • 已配置服务器支持回退到 index.html。

7. Vue Router 配置

  • Hash 模式

    javascript 复制代码
    import { createRouter, createWebHashHistory } from 'vue-router';
    
    const router = createRouter({
      history: createWebHashHistory(),
      routes: [...],
    });
  • History 模式

    javascript 复制代码
    import { createRouter, createWebHistory } from 'vue-router';
    
    const router = createRouter({
      history: createWebHistory(),
      routes: [...],
    });

总结对比表

特性 Hash 模式 History 模式
URL 格式 带 #(如 /#/about) 无 #(如 /about)
服务器配置 无需特殊配置 需配置重定向到入口文件
兼容性 支持所有浏览器 不支持 IE9 及以下
SEO 友好性 较差 较好(需结合 SSR/预渲染)
实现原理 hashchange 事件 History API

根据项目需求选择模式:优先推荐 History 模式 (URL 简洁,SEO 友好),若需兼容旧环境或简化部署,可选用 Hash 模式。

相关推荐
福兮说3 小时前
设计稿是 #4A7C6F,页面量出来是 #4B7C6F:HEX、HSL、透明度、canvas 来回转的七个坑
前端·javascript·css·canvas
郑州光合科技余经理4 小时前
海外版外卖加盟:总站与分站配送规则怎么分开管
java·开发语言·前端·后端·uni-app·php·ai编程
小呆呆6665 小时前
副业搞起来,小说,漫画,漫剧的成本优化思路
前端·后端·面试
Dovis(誓平步青云)5 小时前
浇水提醒刚弹出又消失,植物状态别只存一个百分比
开发语言·前端·javascript·pdf·ecmascript·电脑
码艺-Alimjan5 小时前
Vben Admin 新增维吾尔语 Vben-Modal的关键坑之一
前端·javascript·vue.js
可乐鸡翅yeah_6 小时前
hls.js 手动自定义 http 请求 loader,修改请求头实战
开发语言·前端·javascript·网络协议·http·ecmascript·m3u8在线
IT_陈寒6 小时前
Vite静态资源导入这个坑我帮你们踩过了
前端·人工智能·后端
广州华水科技6 小时前
大坝安全监测解决方案:单北斗GNSS形变监测系统应用与维护
前端
yivifu7 小时前
中文古籍电子书注释集成
前端·javascript·python·beautifulsoup·epub
默_笙8 小时前
🛴 从散件到整机:DeepAgents 与 Agent 身上预留的那些"插槽"(前置介绍)
前端·javascript