边缘节点上不能用 document.getElementById，因为 Cloudflare Workers、Fastly Compute@Edge 等边缘运行时无 DOM 环境，document 对象根本不存在，直接调用会抛出 ReferenceError；正确做法是用字符串模板或 HTMLTemplateElement 模拟服务端组装，所有上下文（如地理位置、设备信息）须由边缘平台通过请求头或内置变量透传，禁止依赖客户端 JS 获取或在边缘维护复杂状态。
边缘节点上不能用 document.getElementById，为什么？
因为边缘运行时（如 Cloudflare Workers、Fastly Compute@Edge）没有 DOM 环境，document 对象根本不存在。常见错误是把前端逻辑直接搬过去，一执行就报 ReferenceError: document is not defined。这不是配置问题，而是架构层级的错配——边缘不是浏览器，它不解析 HTML、不挂载元素、不触发生命周期。
真正可行的是服务端字符串组装：用模板字符串、Mustache 或轻量级模板引擎，在请求到达时拼出完整 HTML 片段。所有变量必须来自请求上下文（如 request.headers.get('User-Agent')、env.GEO_REGION），而非客户端 JS 获取。
- 禁止在边缘函数里写
document.createElement、innerHTML、querySelector - 允许用
String.prototype.replace、new URL()、JSON.stringify()这类纯 JS 字符串/对象操作 - 若需结构化生成，优先用
HTMLTemplateElement的服务端模拟逻辑（即手动构造字符串，非真实 DOM 实例）
v-html 在边缘渲染中完全不适用
v-html 是 Vue 的运行时指令，依赖浏览器 DOM 和 Vue 响应式系统，只能在客户端执行。把它放到边缘节点会直接失败——既没 Vue 实例，也没 el.innerHTML 可赋值。
真正的替代方案是：在边缘完成 HTML 字符串拼接，把最终结果作为 HTTP 响应体返回；客户端只做最小化接管（比如补动态评论、埋点），而不是靠 v-html 二次渲染。
立即学习“前端免费学习笔记（深入）”；
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
- 边缘层输出的 HTML 必须是“可直接流式返回”的完整片段，含
<!DOCTYPE html>和基础样式 - 个性化区块（如用户昵称、本地天气）要提前注入，不能留空位等客户端填
- 如果必须保留部分动态能力，用 ESI（Edge Side Include）语法或自定义占位符（如
<!-- USER_NAME -->），再由边缘脚本替换
缓存键设计决定个性化能否生效
边缘缓存默认按 URL 缓存，但新闻、用户仪表盘这类页面，同一 URL 下内容千差万别。若不做区分，北京用户看到上海用户的首页，或未登录用户看到已登录态的 HTML，就是典型缓存污染。
关键是在缓存键中显式包含影响内容的维度，例如：url + geo + device + auth_status。Cloudflare Workers 中可用 cacheKey = new URL(request.url).toString() + request.cf.city + request.headers.get('User-Agent').includes('Mobile')。
- 静态区块（如页眉、页脚）可设长缓存（
Cache-Control: public, max-age=3600） - 个性化区块（如推荐栏、实时评论数）必须禁用缓存或设极短 TTL（
max-age=10） - 避免用 Cookie 生成缓存键——多数 CDN 默认不将其纳入缓存哈希，除非显式开启
Include-Cache-Key-Headers
流式响应比整页组装更抗延迟
等所有数据（API 调用 + 模板渲染）全部完成再返回 HTML，会放大首字节时间（TTFB）。尤其当中心 API 偶尔慢时，用户白屏时间直线上升。
更优做法是流式组装：先返回 HTML 开头（doctype、head、骨架），再边 fetch 边写入 body 内容。Cloudflare Workers 支持 ReadableStream + TransformStream，Fastly 支持 streaming 模式。
- 静态框架部分（导航栏、加载占位符）应硬编码在边缘函数开头立即写出
- 动态区块用占位符包裹（如
<div id="news-list">{NEWS_CONTENT}</div>），fetch 完成后 replace - 注意流式响应无法设置
Content-Length，需用Transfer-Encoding: chunked，客户端需兼容
边缘渲染真正难的不是拼字符串，而是厘清哪些该在边缘做、哪些必须回源、哪些干脆不该动——比如“已读文章列表”这种有状态的数据，边缘只传 token 校验，真实读取仍走中心服务。混淆这个边界，迟早掉进缓存不一致或安全漏洞的坑里。
