hash 模式：URL 带 #（如 /#/user），# 后面的内容不会发给服务器，靠监听 hashchange 事件切换视图。优点是零服务端配置、刷新和直达子路径都不会 404、兼容性好；缺点是 URL 不美观、对 SEO 不友好。history 模式：URL 是真实路径（如 /user），基于 pushState / replaceState 和 popstate 事件。优点是 URL 干净、利于 SEO 和分享；缺点是强依赖服务端配置——必须把所有未匹配路径回退到 index.html（Nginx 用 try_files $uri $uri/ /index.html;，OBS 静态网站托管把错误页面指向 index.html），否则深链接刷新会 404。 迁移时注意：先上线并验证服务端回退配置，再 history 版本前端；前端的 base（如 createWebHistory('/app/')）要和构建工具的 publicPath 保持一致；老的 /#/xxx 链接可加一段过渡逻辑跳转到新路径；第三方授权回调白名单、分享签名、埋点上报要按新 URL 一并更新并验收。发布