给一个静态站做体检:20 张图缺尺寸、5 个页面描述过短、动图 461 KB
周末拿自己的站做了一轮体检:用 headless 浏览器逐页量标题/描述/图片尺寸/元信息,查出 20 张图没有 width/height、5 个页面描述太短、全站 og:image 缺尺寸、404 页挂着一张 461 KB 的 GIF。逐条修完,附修法和前后数字。
站点跑起来之后最容易忘的一件事:没人再量它了。这次拿自己的站当靶子,用无头浏览器逐页扫,查出六类问题,全修了。
一、20 张图没有 width / height#
滚动时图片从 0 高度撑开,正文被往下推。用 Chrome DevTools 协议量的结果:
| 页面 | 缺尺寸的图 |
|---|---|
/live/ | 9 |
/ | 4 |
/stickers/ | 3 |
/intel/… 正文 | 4 |
根因不只是「忘了写」:正文图是 Markdown 渲染器生成的 <img>,它根本不知道图片多大。
修法:写了个零依赖的尺寸解析器,读文件头判断格式再取宽高——PNG 从 IHDR,GIF 从逻辑屏幕描述符,WebP 分 VP8 / VP8L / VP8X 三种,JPEG 要顺着 marker 找到 SOFn。
构建时扫一遍 assets/ 建映射,渲染时给 <img> 补上:
<img src="/assets/asset100/hands.webp" width="1600" height="246" loading="lazy">结果:缺尺寸 20 → 0。
二、全站 og:image 没有尺寸#
分享到微信/Twitter 时,卡片首屏常常是空白或慢半拍,因为爬虫要先下载整张图才知道比例。
补了 og:image:width/height/alt/locale 和 twitter:image/title/description。11 个页面从全缺 → 全有。
三、5 个页面 description 过短#
首页 49 字、情报列表 30 字、运营台 37 字、搜索页 8 字。搜索结果里这些描述基本等于没写。
补到 50–150 字,并把写入规则定死:标题超 60 字就不再拼站点名,不然关键词会被站名挤掉。
四、404 页挂着一张 461 KB 的 GIF#
呼吸动图原来是 GIF,461 KB;同目录还躺着一张 292 KB 的静态 WebP 当候选。404 页比首页还重。
转成 180px 动画 WebP:461 KB → 123 KB,省 338 KB。没人引用的那张 292 KB 从产物里删掉。
五、服务器没开 gzip#
线上对 Accept-Encoding: gzip 无动于衷。实测三个文本文件:
| 文件 | 原始 | gzip 后 |
|---|---|---|
site.css | 66 KB | 21.4 KB |
index.html | 18 KB | 7.8 KB |
site.js | 12.5 KB | 5.4 KB |
Windows Server 上打开它需要先装角色功能(Web-Stat-Compression、Web-Dyn-Compression,默认不装),再在 web.config 里开 urlCompression 并确保静态类型白名单里有 text/css。
六、缓存策略把更新挡住了(这条最坑)#
给 /assets 设了 7 天缓存,但文件名没有指纹——结果我改了样式,自己浏览器里看到的还是旧的,一度以为没生效。
正确的做法是内容指纹 + 长缓存:
/assets/site.css?v=<内容hash> → 缓存 1 天,改一次换一次 URL
/*.html → 缓存 5 分钟指纹把 CSS、JS、logo、favicon、apple-touch-icon 一起算进去——只 hash CSS 会导致换了头像 URL 不变,这个坑我踩了一次。
顺手做的几件小事#
- 首页 JSON-LD 加
SearchAction(站内有搜索,能出现在结果里的搜索框) - logo 从 128px PNG(29 KB)换成 64px WebP(2.3 KB),去掉
fetchpriority=high——它不该和首屏大图抢带宽 - 备案号按规链接到工信部备案系统
- 每页
h1恰好 1 个、无重复 id、图片全带alt(这轮复查仍然通过)
复查结果#
缺尺寸图 20 → 0
描述过短页 5 → 0
og 尺寸缺失 11 页 → 0
404 动图 461 KB → 123 KB
首屏文本 93.8 KB → 34.6 KB(gzip 后)
死链 0(29 页 / 67 个内部链接)还没解决的#
- HTTPS 还没上:证书申请卡在服务器缺运行时,改走控制台申请免费证书
- CSS 尾部有 280 行补丁:约 7 KB 死规则、断点散落,得逐屏回归后重排
- 素材页 12 张白底贴纸:在深色页里太抢眼,要重出透明底
体检脚本留着了,以后每次改完跑一遍,比凭感觉「应该没问题」强。
关于准确性:文中「实测」均来自我们自己的机器,标注了日期;厂商参数以官方文档为准。发现错误,告诉我们,会改并记一笔。