图像工具

图片 Base64 编码

将图片转换为 Base64 编码,生成 Data URL,支持双向转换

选择图片
💡 使用说明
Data URL 格式:data:image/png;base64,iVBORw0KGgoAAAANS...

可直接用于 HTML img 标签的 src 属性或 CSS background-image

Base64 纯文本:iVBORw0KGgoAAAANS...

仅包含 Base64 编码字符串,需要手动添加前缀使用

什么是图片 Base64 编码?

Base64 是一种将二进制数据编码为文本的编码方式。图片 Base64 编码工具可以将图片转换为 Base64 编码字符串,生成 Data URL 格式,可以直接嵌入到 HTML 或 CSS 中,无需额外的图片文件。

格式说明

  • Data URL:完整的 Data URL 格式,包含 MIME 类型前缀,可直接使用
  • Base64 纯文本:仅包含 Base64 编码字符串,需要手动添加前缀

使用场景

  • 内联图片:将小图片直接嵌入 HTML/CSS,减少 HTTP 请求
  • 邮件模板:在 HTML 邮件中嵌入图片
  • API 响应:在 JSON 中直接包含图片数据
  • 离线应用:将图片数据存储在本地

注意事项

  • Base64 编码会增加约 33% 的文件大小
  • 建议只对小图片(< 100KB)使用 Base64 编码
  • 大图片使用 Base64 会影响页面加载性能
  • 所有处理在浏览器本地完成,不会上传到服务器

使用示例

  • HTML:<img src="data:image/png;base64,..." />
  • CSS:background-image: url('data:image/png;base64,...');

把本地图片文件读成 Data URL 或纯 Base64 字符串,也能把这两种形式还原成可预览、可下载的图片。适合把小图标内联进 HTML 或 CSS、在 JSON 接口里随响应传图,或者从日志、配置里粘出的 Base64 片段中救回原始文件。

编码读的是文件原始字节

整个过程只有一次 FileReader.readAsDataURL(),因此得到的 Base64 是磁盘文件逐字节的重新编码:不经过 canvas,不做缩放、重新压缩,也不剥离元数据。上传 300 KB 的 PNG,载荷就是约 40 万个字符,预览里显示的也正是你上传的那个文件。前缀中的 MIME 并非从字节嗅探,而是取自 file.type,由浏览器按扩展名经操作系统映射得出。把 photo.jpg 改名成 photo.png,得到的就是 data:image/png;base64, 加一段 JPEG 字节:浏览器通常照常显示,但严格的消费方会拒绝——对象存储的 content-type 校验、toBlob 重新导出、上传接口的类型检查,都以声明的类型为准。

输出为什么长成这样

Data URL 由 data:、媒体类型、;base64, 和载荷拼成,段与段之间没有空白。PNG 的前缀固定 22 个字符,SVG 因为是带加号的子类型 svg+xml 变成 26 个。载荷按每 3 字节 4 字符向上取整:1000 字节的图标变成 1336 个字符(原体积的 133.6%),文件越大越逼近 133.3%。字节数能否被 3 整除决定结尾是 = 还是 ==:69 字节正好 23 组,结尾干净;68 字节就要补 ==。PNG 的 8 字节签名编码为 iVBORw0KGgo=,其后必是长度 13、类型 IHDR 的首块,所以任何 PNG 载荷都以 iVBORw0KGgoAAAANSUhE 开头;JPEG 开头是 /9j/,GIF 是 R0lGOD,WebP 是 UklGR。想快速判断声明的 MIME 可不可信,看开头这几个字符最省事。

解码阶段工具替你做的假设

解码既接受完整 Data URL,也接受裸 Base64。裸字符串会被硬编码补上 image/png 前缀,然后做一次形状校验,要求形如 data:image/<子类型>;base64,。之后没有字节级检查:真正的验证是把字符串赋给 Image 对象等 load 事件,由浏览器自己的图片解码器裁决。于是「语法正确、内容却不是图片」的输入会静默失败,既不显示预览,也不给出明确报错。下载时用 atob 还原字节装进类型为 image/<子类型> 的 Blob,文件名固定为 decoded-image.<子类型>:SVG 会得到 decoded-image.svg+xml 这种系统不认识的后缀,而不带前缀粘贴的 JPEG 会被存成 decoded-image.png,内容与扩展名并不一致。

实操示例

给一个 69 字节的 1×1 PNG 编码

输入
pixel.png:1×1 像素、8 位 RGB、纯红(#ff0000)、磁盘上 69 字节
输出
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGP4z8AAAAMBAQDJ/pLvAAAAAElFTkSuQmCC

69 字节正好是 23 个三字节组,所以载荷是 92 个字符、结尾没有 = 填充;加上 22 个字符的前缀,整个 Data URL 为 114 个字符。切换到纯 Base64 模式拿到的还是这 92 个字符,只是前缀被切掉,预览完全一样,因为两种模式都没有改动被编码的字节。

边界与常见误用

  • 组件里没有任何文件体积上限常量,真正的限制来自浏览器内存和渲染这个字符串的 textarea——几 MB 的照片就是几 MB 的文本节点。
  • 只有当 file.type 以 image/ 开头的文件才会被接受,扩展名冷门或系统未注册 MIME 的图片在编码前就被挡下。
  • 输出是连续单行,载荷不会按 76 字符折行,接入有行长硬要求的 MIME 或邮件场景前需要自己重新换行。
  • 解码时裸 Base64 一律按 PNG 处理,粘进来的若是 JPEG 或 WebP,下载得到的文件扩展名就是错的。
  • 前缀跟着扩展名走而非内容走,确认文件的真实格式要看开头那几个 Base64 字符,而不是相信 data:image/...。

相关工具

出问题时先看这里

设计工具导出的 Data URL 一粘就报「无效的 Base64 格式」,可同一个字符串在浏览器标签页里能正常显示。

原因形状校验是 /^data:image\/[^;]+;base64,/,它要求子类型之后紧跟 ;base64,。SVG 导出常见的 charset=utf-8 参数插在中间,那个位置就变成了 ;charset=utf-8;base64,,正则在此处匹配失败,字符串还没交给任何解码器就被拒。

处理把参数删掉,让前缀回到 data:image/svg+xml;base64, 再解码。别改成只粘逗号后面的裸载荷:SVG 会被当成 PNG,下载出来的文件叫 decoded-image.png,内容却是 SVG 文本。

从纯 Base64 模式复制出去的字符串,塞进 src 属性或 CSS 的 url() 里,图片显示成裂图。

原因纯 Base64 模式把第一个逗号之前的全部内容切掉了,其中就包括 22 个字符的 data:image/png;base64,。URL 位置需要这段头来说明字节是什么;裸载荷编码再合法,它也不是一个 URL。

处理改用 Data URL 模式重新复制,或者自己把前缀补回载荷前面,并让子类型与字节一致:PNG 的头是 22 个字符,对象存储的类型校验这类严格消费方会直接拒绝头与内容不符的数据。

解码成功之后想单独拿走纯载荷,界面上的 Data URL / 纯 Base64 开关却不见了。

原因那个开关渲染在编码模式的上传区标题栏里,一切换模式就消失。解码模式只有输入框、解码按钮,以及加载成功后出现的下载按钮;字符串保持它进来时的样子,不会改头。

处理切回编码模式,把同一个文件重新选一次再切到纯 Base64;或者手工删掉第一个逗号及其之前的字符。解码从不重写前缀,输出形态完全由输入决定。

刚编码完切到解码模式,输入框里已经有内容了,像是偷偷读了剪贴板。

原因两个模式共用同一个 base64String,切换单选按钮只改变渲染哪一块,没有任何清空动作;而编码输出恰好就是解码分支期待的输入。

处理直接点解码按钮,正好可以验证这个文件的往返是否无损;不需要的话点输入框标题栏的「清空」,它会把字符串、预览和文件输入一起重置。

一张手机截图编码完,输出框里是几百万个字符,滚动都开始卡。

原因一次 FileReader.readAsDataURL 把整个文件读成单个字符串,预览和只读文本框共用它,长度按 4 × ⌈n / 3⌉ 计算:3,200,000 字节变成 4,266,668 个字符,末尾还要为余下的 2 字节补位。组件里没有任何体积上限常量,所以拦不住这种输入。

处理先用图片压缩降质量或缩尺寸,或用格式转换转成 WebP,再编码小一点的文件。这张图如果只是要展示,就别内联,直接用文件引用。

当场内联、写脚本,还是交给构建器

你的处境本页的图片 Base64换成哪个
只有一两张图标要塞进标记里编码模式丢进文件、复制 Data URL 就行:3,024 字节的图标,载荷是 4,032 个字符(每 3 字节出 4 个,3,024 正好整除),加上 PNG 头,框里数出来是 4,054。就一两张、还想先看预览再粘贴,手工这一步值得。图标是跟着项目长期发布的,就让构建器做:Vite 会把小于 assetsInlineLimit(默认 4,096 字节)的资源改写成 Data URL,超出的仍留成独立文件。每次发版都要重新生成、不想手工再复制的场合,走构建期。
手里有一段 Base64,要还原成磁盘上的文件解码模式先把图画出来,再存成 decoded-image.<子类型>;没带任何前缀的裸串一律当 PNG,文件名可能和真实字节对不上。想先看一眼再决定叫什么,用本页。命令行 base64 --decode < payload.txt > out.jpeg 把字节原样写出,名字由你定,字符串也不必停留在文本框里。格式已经确定、载荷又有几 MB 时,交给终端。
要编码的是字体、wasm 或者 PDF这条路走不通:选择文件时 file.type 不是以 image/ 开头就被拦下并清空输入框,解码侧也只靠 Image 能否加载来判定。用本站的文件转 Base64,它收任何文件,只在超过 50 MB 时拒绝;或者干脆 base64 < font.woff2,终端根本不问媒体类型。字节从一开始就不是图片,就别在这页绕。
原图本身就有好几 MB本工具不做压缩也不做缩放,文本长度就是 4 × ⌈n / 3⌉:4,194,304 字节的照片会变成 5,592,408 个字符,作为一个文本节点渲染,旁边还挂着解码后的预览位图。只有本来就打算内联的图,才值得这么走。先瘦身:要质量用图片压缩,要格式用格式转换转成 WebP,再拿结果来编码。这串字符最终进 HTML 或 CSS 时尤其要先压后编——那里面它会随文档一起下载,没法单独缓存。
你只想知道像素尺寸或真实格式本页给的是字符数,外加一个只有编码模式且原文件还在时才出现的 KB 值,从来不报像素。你要的数字就是「写进文件后会占多少字符」,才用它。图片信息查看器直接读文件头,给出像素、格式和透明通道,不用先编码。还在权衡要不要内联时用它更对——真正决定预算的是像素尺寸,不是编码长度。

常见问题

什么情况下该把图片转成 Base64 内嵌?
适合:小于 2–3 KB 的图标、Logo、加载占位图——省一次 HTTP 请求且随文档缓存。不适合:内容图片和大图(体积 +33%、无法单独缓存、阻塞 CSS 解析)。经验法则:会出现雪碧图里的才考虑内嵌。
内嵌图片影响网页性能吗?
两面性:省请求但不缓存——每个引用页面都要重新下载整份 CSS/HTML;且 Base64 段会增大解析体积。Lighthouse 会把大段 Base64 列为优化项。折中方案:小图标用 SVG 内嵌,照片走独立文件+懒加载。
为什么转换后图片"打不开"了?
多数是用途错配:把纯 Base64 直接存成 .jpg 文件(缺少二进制头),或在 Data URI 里 MIME 类型与实际格式不符(png 写成 jpeg)。本工具输出时自动附带正确的 MIME 前缀,反向解码时也能识别类型。

内容复核: