纯HTML+内联style+base64图片可构建稳定错误页，因不依赖外部资源，避免404/500时样式或脚本加载失败导致白屏；需强制声明DOCTYPE、meta charset，并由服务端显式设置HTTP状态码。
直接用纯 HTML + 内联 style + base64 图片，就能做出稳定可靠的错误页；任何后端（Nginx、Express、PHP）都能无缝接入，且完全不依赖外部资源加载失败的风险。
为什么不能用外链 CSS/JS 或普通图片路径
错误页本质是「兜底场景」：用户已经遇到 404/500，说明资源链路大概率已断裂。此时若页面还依赖 ./css/error.css 或 /js/tracking.js，很可能连样式都加载不了，只剩白屏或裸文本。
-
link标签引用的 CSS 文件 404 → 页面无样式，文字堆叠、字号错乱 -
script标签加载失败 → 若含错误上报逻辑，就彻底失效 -
img src="/img/404.svg"路径错误或服务器未配静态路由 → 显示破损图标，甚至触发二次 404 - 相对路径（如
../assets/warning.png）在不同 URL 深度下解析结果不同，Nginx 的error_page重定向后路径上下文已变
必须写死的三个关键点
不是“建议”，而是只要漏掉一个，就可能让错误页在真实故障中失效。
-
<!DOCTYPE html>必须存在且独占首行——否则 IE 和旧版 Safari 进入怪异模式，flex布局全崩 -
<meta charset="utf-8">必须在<head>靠前位置——避免中文乱码，尤其错误信息含中文时 - HTTP 状态码必须由服务端显式设置，不能靠前端 JS 伪造——浏览器地址栏显示 200，但内容是 404，SEO 和调试工具都会误判
例如 Nginx 配置中要写：error_page 404 /404.html; location = /404.html { internal; }，其中 internal 防止用户直接访问该页导致状态码变成 200。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
立即学习“前端免费学习笔记（深入）”；
base64 图片和内联样式怎么写才安全
不是所有 SVG 都适合转 base64。压缩后的 SVG 字符串如果含未转义的 &、 或换行，直接塞进 <code>src="data:image/svg+xml;base64,..." 会解析失败。
- 先用在线工具（如 https://svgomg.net）精简 SVG，删注释、冗余属性、空白符
- 再用 Base64 编码器（推荐 https://www.base64encode.org）编码，选 “URL-safe” 模式（替换
+//为-/_） - 最终写法示例：
<img src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjxjaXJjbGUgY3g9IjUwIiBjeT0iNTAiIHI9IjQ1IiBmaWxsPSJub25lIiBzdHJva2U9IiNmZmYiIHN0cm9rZS13aWR0aD0iMiIvPjwvc3ZnPg=="> - 内联
<style>放在<head>里，别用scoped或 CSS-in-JS——那些只在 SPA 场景有效
响应式与语义化容易被忽略的细节
很多模板写了 @media 却没加 <meta name="viewport">，导致手机上缩放错乱；或者用一堆 <div class="title">，结果屏幕阅读器读不出层级。
- 必须加：
<meta name="viewport" content="width=device-width,initial-scale=1"> - 标题用
<h1>，次要信息用<p>，不要全用<div>+ CSS 控制视觉大小 - 错误码数字（如 404）单独包一层
<span class="code">404</span>，方便后续加动画或高对比色 - 返回链接用
<a href="/">回到首页</a>，别用javascript:history.back()——用户可能从外站跳入，history.length === 1时会失效
最常被跳过的其实是 HTTP 状态头本身：模板 HTML 写得再漂亮，如果后端没调用 res.status(404) 或没配 Nginx 的 error_page 指令，浏览器收到的仍是 200 OK，整个错误机制就形同虚设。
