一个单文件页面的需求,让我重新审视 Base64 图片
前阵子我要做一个单文件 HTML 小页面:一个离线也能打开的演示页,里面有 logo、几个小图标,还有几张操作截图。需求很明确,最好只有一个 .html 文件,双击就能看,整体发给别人也不会因为漏带图片文件夹而裂图。
我当时的第一反应很简单:把所有图片都转成 Base64,内嵌进 HTML,这样图片就“长”在文件里,不依赖任何外部地址。开头确实顺利,文件随便拷、随便发,图都在。可随着截图越加越多,页面开始不对劲——这也是我想把这件事彻底理清的原因。
先搞懂:Base64 内嵌到底对图片做了什么
所谓 Base64 内嵌,就是把图片的二进制数据用 Base64 编码成一长串纯文本,以 data URI 的形式直接写进 HTML 或 CSS,大致长这样:
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...(一长串)">
浏览器读到这段文本,会在本地把它解码、还原成图片再显示,整个过程不发起任何网络请求。
而外链是另一种思路,HTML 里只存一个图片地址:
<img src="https://example.com/shot.png">
图片本体放在服务器上,由浏览器单独发请求去取。
这里有个容易被忽略的细节:Base64 编码会让数据体积大约多出三分之一,因为它把每 3 个字节编码成 4 个字符。也就是说,一张 30 KB 的图,内嵌后那串文本大约占 40 KB。图片越大,这部分多出来的体积越可观。
把大图也内嵌之后,页面开始变卡:我的排查过程
问题是在我把几张操作截图也内嵌之后出现的。单文件 HTML 从最初的几十 KB 一路涨到好几 MB,文本编辑器里往下滚都吃力,浏览器首次打开也明显变慢。我没有急着改,而是一步步排查。
- 先看体积构成:统计后发现,几个小图标占的编码很短,真正把文件撑大的是那几张截图,每张都对应一大段 Base64 文本。
- 再看缓存行为:内嵌图是写死在 HTML 里的,浏览器没法把它单独缓存。每次打开这个页面,都要连同文档一起重新解析、解码;如果别的页面也想用同一张图,只能再内嵌一份。
- 检查重复引用:有个小图标在 CSS 里被好几处用到,我图省事直接把同一段 Base64 复制了多遍,体积成倍增加。改成外链的话,浏览器只需下载一次,之后都走缓存。
- 看渲染路径:大段 Base64 文本夹在 HTML 里,会拖慢文档解析;图片本可以在文档解析的同时并行加载,内嵌后却变成了“先读完一大串文本再解码”。
排查到这里结论就清楚了:不是 Base64 不好,而是我把它用在了不该用的大图上。 小图标内嵌很合适,截图这种体积大、又可能复用或更新的图,内嵌纯属给自己找麻烦。
Base64 内嵌和外链,机制上差在哪
我把两种方式的关键差异整理成一张表,之后做选型直接对照:
| 对比维度 | Base64 内嵌(data URI) | 外链(http 图片地址) |
|---|---|---|
| 图片放在哪 | 编码成文本写进 HTML/CSS | 独立文件,HTML 里只存地址 |
| 网络请求 | 不产生图片请求 | 每张图一个请求,可被缓存 |
| 浏览器缓存 | 随文档一起,无法单独缓存 | 可独立缓存,多页面复用 |
| 实际占用 | 约为原图的 4/3 | 即图片原始体积 |
| 更新一张图 | 要替换整段编码 | 覆盖文件即可,地址可保持不变 |
| 适合的图 | 小图标、装饰图、单文件分发 | 内容大图、常变图、需加速的图 |
| 离线单文件 | 天然支持 | 需联网,或额外打包资源 |
什么时候该用 Base64:小而稳定的图
结合这次踩坑,我给 Base64 内嵌定了几个前提,同时满足才考虑:
- 图片足够小:比如几 KB 的图标、分隔符、小 logo,编码后那串文本可以接受。
- 单文件或离线分发:明确不希望带一堆资源文件,要的就是“一个文件走天下”。
- 想减少请求数:页面上有大量小图时,逐个请求的开销有时比多一点体积更明显。不过现在 HTTP/2 普及后请求可以多路复用,这个优势已经没以前那么大。
- 图片基本不变:不要求独立缓存、也不打算频繁替换。
一句话:Base64 留给“小而稳定”的图。
什么时候该用外链:大图、复用图和会变的图
外链的适用面其实更广,下面这些情况我都会明确走外链:
- 内容配图、截图、照片这类体积较大的图,交给浏览器并行加载、单独缓存,而不是塞进 HTML 拖慢解析。
- 多个页面共用的图,只下载一次、缓存复用,避免在每个页面重复内嵌。
- 会更新的图,用支持同名覆盖的外链,替换文件后地址不变,文档里的链接不用动;内嵌则要重新生成、替换整段字符串。
- 需要懒加载、按屏幕分档或海外加速的图,这些能力都建立在独立外链之上,内嵌无法实现。
我之前分别记录过单文件 HTML 的托管与预览和文件直链的使用边界,和这次的内嵌、外链取舍正好能对照着看。
我现在固定的做法:一套素材,两种链接按需取
理清边界后,我没有在“内嵌”和“外链”里二选一,而是让同一套素材同时支持两种用法,按图片性质各取所需:小图标和离线单文件里的装饰图取 Base64 内嵌,正文大图、需要复用和会更新的图取 URL 或 Markdown 外链。
具体落地时,我习惯把图片统一传到一个能同时给出多种输出格式的地方,再按场景复制对应格式。我自己用的是图床小镇,上传后可以直接在 URL、Base64、Markdown 这几种输出里选:同一张图要内嵌就拿 Base64、要外链就拿 URL,不必在几个工具之间来回转换。换成任何具备同样多格式输出能力的服务,这套方法都成立,关键是先按图片大小和用途判断,而不是默认全内嵌。
落地前的自检清单
最后是我每次提交前会过一遍的检查项:
- 内嵌前先看图片体积,偏大的一律改走外链,不凭感觉。
- 检查同一图标是否在多处重复内嵌,重复就改成外链或用一个 CSS 类复用。
- 单文件分发时确认内嵌图齐全;若保留外链,标注清楚这些图需要联网才显示。
- 大图确认走的是可缓存、可加速的外链,而不是写进文档。
- 会更新的图使用能同名覆盖、地址不变的外链,避免每次改图都动正文。
- 通读一遍,确认没有把“省事”建立在让页面整体变卡的代价上。
图片内嵌还是外链,本质是在请求数、体积、缓存和维护成本之间做权衡。把小图和大图分开对待,单文件页面既能保持干净,也不会在打开时卡顿。
官网:imgbed.cn