静态托管平台自动接管404需满足三条件:文件名必须为小写404.html、置于项目根目录、h1标签直写“404”;本地file://打开无效,因无HTTP状态码;验证须用HTTP服务或curl检查Status为404。

直接放根目录的 404.html 文件,不配服务器、不写 JS、不连 CDN,就能让静态托管平台(GitHub Pages / Vercel / Netlify)自动接管 404 请求——但前提是文件名、路径、结构三者全对,错一个就退回平台默认灰页。
为什么本地双击打开 404.html 永远不生效
浏览器用 file:// 协议打开时,压根没有 HTTP 状态码概念。你看到的只是个普通 HTML 文件,状态码是 200,不是 404。搜索引擎会把它当正常页面收录,用户点搜索结果进来也意识不到这是死链。
- 验证必须走真实 HTTP:用
npx serve -s启服务,再访问http://localhost:5000/xxx-abc - 或命令行跑
curl -I https://yoursite.com/nonexistent,第一行必须是HTTP/1.1 404 Not Found - Chrome DevTools → Network → 找那个请求 → 看 Response Headers 里的
Status字段
404.html 必须满足的三个硬性条件
静态托管平台只认“名字对 + 位置对 + 结构对”,三者缺一不可。
- 文件名必须是纯小写
404.html,不能是404.htm、error404.html、404.HTML(Windows 记事本可能偷偷加 BOM,用 VS Code 或git ls-files | grep 404检查) - 必须放在仓库或项目根目录,和
index.html同级;pages/404.html或src/404.html都无效 -
标签里必须直写 “404” 文字,比如,不能用图片、SVG、JS 插入,否则屏幕阅读器读不出、SEO 不识别404 Not Found
CSS 必须内联,且不能超过 1KB
外链 CSS 加载失败 = 白屏。404 页面加载失败率比首页高得多,CDN 挂了、路径写错、Nginx fallback 规则吞掉资源,都会让样式丢失。
- 所有样式塞进
标签,删空格、注释、@import - 字体栈用系统级:
font-family: -apple-system, BlinkMacSystemFont, sans-serif,不依赖 Web Font - 文字与背景对比度 ≥ 4.5:1(可用 webaim.org/contrastchecker 验证)
- 别加背景图、动画、Flex/Grid 复杂布局——IE11 和旧安卓 WebView 支持差,居中用
display: flex; height: 100vh;更稳
跳转链接必须是纯 @#@#@#@#@#@#@#@#@#@1,不要
和 setTimeout(() => location.href = '/', 2000)
,input 带 name="q",不依赖 JS 也能提交最常被忽略的其实是语义结构: 包裹核心内容、 含 “404”、rel="nofollow" 加在返回链接上——这些不是锦上添花,而是让爬虫和屏幕阅读器真正把它当错误页识别的关键信号。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











