history.pushState是实现真正SPA的起点，它使URL变更、后退/前进、书签分享成为可能；若仅操作innerHTML而未配合pushState与popstate监听，则仅为伪SPA，缺乏导航生命周期接管、服务端fallback等关键环节。
history.pushState 是唯一能真正让单页应用“像多页一样用”的起点。不加这句，所有切换都只是 DOM 显示/隐藏，URL 不变、后退键失效、书签无法保存——这不是 SPA，只是个带按钮的 div 切换器。
为什么直接改 innerHTML 会卡在“伪 SPA”阶段
很多开发者把多个页面 HTML 块塞进一个文件，再用 document.getElementById('app').innerHTML = template 替换内容，以为这就完成了 SPA 改造。但问题立刻暴露：
- 点击浏览器后退按钮，页面直接跳回上一个真实 URL（比如 google.com），而不是回到上一个“视图”
- 刷新当前页面，
/user/profile变成 404 —— 服务端根本没这个路径 - 分享链接
yourapp.com/#profile看似能用，但#锚点无法被搜索引擎索引，也不支持pushState的状态对象 - 每次切换都要重新解析整段 HTML 字符串，没有组件复用，
addEventListener容易重复绑定
核心缺失是：没接管浏览器的导航生命周期。你得告诉浏览器“这个 URL 变化是我控制的”，而不是让它默认走完整刷新流程。
popstate 事件必须和 pushState 成对出现
只调用 history.pushState({page: 'settings'}, '', '/settings')，却不监听 popstate，等于只发了出发信号，没配接收器。用户点后退时，URL 变了，但页面内容纹丝不动。
- 必须在页面加载后立即监听：
window.addEventListener('popstate', handleRoute) -
handleRoute函数里要能从event.state?.page或location.pathname提取目标路径 - 首次加载也要手动触发一次路由处理，否则初始 URL（如
/dashboard）不会渲染对应视图 - 注意：
popstate在页面首次载入时不会触发，哪怕 URL 带有有效路径
漏掉首次执行，是上线后“首页白屏”最常见原因。
立即学习“前端免费学习笔记（深入）”；
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
模板字符串 + Element.replaceChildren() 比 innerHTML 更安全
用 innerHTML 插入动态内容，容易引入 XSS 风险，也难以清理旧事件监听器。现代做法是：
- 用
template标签预存结构：<template id="user-view"><h2>User <span class="name"></span></h2></template> - 克隆并填充：
const t = document.getElementById('user-view').content.cloneNode(true); t.querySelector('.name').textContent = data.name; - 替换内容区：
appEl.replaceChildren(t)—— 自动移除旧子节点，不残留事件监听器 - 避免用
eval或new Function解析模板逻辑，所有数据绑定手动控制
这种写法不依赖框架，但要求你严格管理每个视图的初始化与销毁逻辑。比如切换前要清除定时器、取消 fetch 请求、解绑 scroll 监听 —— 否则内存泄漏比 Vue 还快。
服务端必须 fallback 到 index.html
当你访问 yourapp.com/orders/123，Nginx 或 Vercel 默认会去找 /orders/123.html。它不存在，返回 404。真正的 SPA 路由是前端控制的，所以所有非静态资源请求，都得返回 index.html，再由前端 JS 根据 URL 渲染对应内容。
- Nginx 配置关键行：
try_files $uri $uri/ /index.html; - Vercel：在
vercel.json中加"rewrites": [{ "source": "/(.*)", "destination": "/index.html" }] - 本地开发用
serve -s build（serve 的 -s 参数就是开启 SPA fallback） - 漏配 fallback，测试时一切正常，一部署就全站 404
这个配置不在前端代码里，但它是 SPA 能跑通的最后防线。很多人卡在这里三天，反复检查 JS 逻辑，却忘了服务器根本没把请求交到你的 JS 手里。
