replaceState不会触发popstate事件；它仅静默替换当前历史记录，更新URL和location，但不触发popstate，需手动调用逻辑处理。
replaceState 不会触发 popstate 事件
调用 history.replaceState() 只会静默替换当前历史记录项，浏览器地址栏更新、window.location 同步变化，但不会触发 popstate 事件——这点和 pushState() 完全一致。很多人误以为“替换”会触发监听，结果在事件回调里收不到响应，纯属预期错误。
如果你需要在 replace 后执行逻辑，必须手动调用对应函数，不能依赖事件驱动：
history.replaceState({ page: 'detail' }, '', '/item/123');
updateUIBasedOnState(); // 必须显式调用
state 参数不是 DOM 节点，也不能存函数或 undefined
replaceState() 的第一个参数是 state 对象，它会被序列化进浏览器历史栈，因此只支持可被 JSON.stringify() 安全处理的数据：
- ✅ 允许：普通对象、数组、字符串、数字、null
- ❌ 禁止：
function、undefined、Date、RegExp、Map、Set、DOM 节点、window引用 - ⚠️ 注意：
Date会被转成空对象{}，undefined直接丢失字段
常见翻车写法：
// 错误：传入 Date 实例
history.replaceState({ at: new Date() }, '', '/search');
// 正确：转成 ISO 字符串
history.replaceState({ at: new Date().toISOString() }, '', '/search');
URL 第三个参数必须同源，否则抛 SecurityError
replaceState() 的第三个参数是 URL，它必须与当前页面同源（协议 + 域名 + 端口完全一致），否则浏览器直接拒绝并抛出 SecurityError：
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
- 当前页是
https://a.com/page→ 可以替换成/new、/api/data、https://a.com/other - 当前页是
https://a.com/page→ ❌ 不可替换成https://b.com/xxx、http://a.com/xxx（协议不同）、https://a.com:8080/xxx（端口不同）
开发时容易忽略端口差异，比如本地启了 localhost:3000，却硬编码写成 http://localhost/...（缺端口且协议降级），一跑就报错。
replaceState 后按 F5 刷新，服务端必须能返回对应 HTML
前端用 replaceState() 改了 URL（如从 / 换成 /dashboard），用户此时刷新页面，浏览器会向服务端发起 GET 请求 /dashboard。如果后端没配置路由兜底，就会返回 404。
这是单页应用（SPA）的共性约束，不是 replaceState 特有，但新手常在调试时卡在这一步：
- Webpack Dev Server：加
historyApiFallback: true - Vite：默认已开启
server.historyApiFallback - Nginx：需配
try_files $uri $uri/ /index.html; - Node.js（Express）：需在所有路由之后加
app.get('*', (req, res) => res.sendFile(indexHtml))
最易被忽略的是：开发环境自动 fallback，上线后 Nginx 或 CDN 没配，一刷新就 404 —— 这个坑不发生在代码里，发生在部署环节。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
