这个工具做什么
这个工具把一张本地图片读成文本串,方便直接写进 HTML、CSS、JSON 或配置文件。浏览器提供了 FileReader 接口,可以把文件按字节读出来再做 Base64 编码,工具在此基础上拼成标准的 Data URL。整个过程只用到浏览器的文件读取能力,不涉及画布重绘,也不会改变图片的像素或格式,读到的内容与文件本身一一对应。
输出有两种形式。一种是完整 Data URL,形如 data:image/png;base64,iVBORw0KGgo...,可以直接放进 img 标签的 src、CSS 的 url() 或接口返回的字段里,浏览器看到它会直接解码显示,不需要额外的文件请求。另一种是纯 Base64,去掉了 data:image/png;base64, 这段前缀,适合目标系统已经约定好 MIME 类型、只接收裸字串的场景,例如部分对象存储接口、邮件附件字段或数据库文本列。
图片不会上传服务器,转换在本机完成。工具没有任何网络请求,选中的文件只在当前页面的内存里被读取一次,转换结果也只留在页面上的文本框里。关闭或刷新页面后,这些内容就消失了,不会写入本地存储。
它适合处理小图标、小尺寸的装饰图、演示用的示意图,以及需要把资源塞进单个 HTML 文件的场景。对于照片、商品大图、背景大图,内联通常不是好选择,原因在后面的「结果怎么解读」里说明。
怎么用
把图片拖到虚线区域,或点击该区域从文件选择器里挑一张;文件选择器只显示图片类型。选中后工具会立即读取并转换,不需要再点「开始」之类的按钮。转换完成后,右侧会出现原图预览、完整 Data URL 与纯 Base64 两个文本框,以及文件名、MIME 类型、原始体积、Base64 字符数和体积膨胀比。
- 完整 Data URL:直接复制即可贴进
src属性或url()中,前缀已经包含正确的 MIME 类型。 - 纯 Base64:目标接口只需要裸字串时使用,复制后记得在服务端补上类型信息,否则接收方无法判断这是什么图片。
- 生成 CSS background-image 片段:点一次会在下方写出
background-image: url("data:image/...")的完整声明,粘贴到样式表对应选择器里即可,不必手动拼接引号和分号。 - 清空:释放预览与两个文本框的内容,信息行恢复为占位符,便于换下一张图。
拖拽与点击选择效果相同。一次只处理一张,拖入多张时取第一张并给出提示。SVG 也按普通文件读取,会被 Base64 编码成字串,与 HTML 里直接写 SVG 源码不是一回事。
如果复制按钮没有反应,通常是浏览器的剪贴板权限被限制。此时文本框里的内容仍然完整,可以手动全选后按系统快捷键复制,状态栏也会提示你这样做。
结果怎么解读
Data URL 的结构是固定的:先是 data:,接着是 MIME 类型,然后是 ;base64, 这个标记,最后才是编码后的正文。例如一张 PNG 图片会得到 data:image/png;base64, 开头的内容,SVG 则是 data:image/svg+xml;base64,。中间的 MIME 类型必须正确,写错类型时浏览器可能拒绝显示,即使字串本身没有损坏。纯 Base64 就是逗号之后的全部内容,两者长度相差的正是这段前缀。
Base64 用 64 个可打印字符表示二进制数据,每 3 个字节编成 4 个字符,因此文本长度约为原始字节数的 4/3,也就是增加约 33%。一张 90 KB 的图片,编码后正文大约 120 KB 字符,再加上前缀和换行,整体会更大一些。页面里的「体积膨胀比」是用完整 Data URL 的字符数除以原始字节数算出来的,字符都是单字节,所以这个比值可以直接当作体积比来看。看到 1.33 倍左右属于正常;明显更高,通常是因为前缀较长或文件本身很小、前缀占比被放大。
内联适合这些情况:小于 10 KB 的小图标、只需要在一个页面里出现一次的装饰图、希望把演示页或邮件模板做成单文件、需要避开额外请求的极简页面、以及内容安全策略较严格但允许内联图片来源的环境。内联的好处是省掉一次请求,资源与页面同生共死,不会出现图片路径写错的问题。
不适合的情况同样明确。图片超过几十 KB 后,HTML 或 CSS 文件会迅速膨胀,首屏解析变慢,浏览器也无法像缓存图片那样单独缓存这段文本;同一张图出现在多个页面时,每个页面都要重复一份字串,浪费带宽;需要被压缩算法处理的内容,Base64 之后更难压缩,尤其 SVG 会失去源码里的重复结构;需要按需加载、懒加载或响应式切换多套尺寸的图片,内联会让这些优化失效。照片、商品主图、背景大图应当继续走普通文件地址。
常见情况与限制
2 MB 上限
单张文件限制 2 MB。超过时工具会提示实际大小并停止读取,不会生成半截结果。这样限制的原因是 Base64 会让文本再增大约 33%,2 MB 的文件产生的字串已经接近 2.7 MB,放进编辑器、剪贴板和接口字段里都容易卡顿,也很容易触发后端对字段长度的限制。更大的图片应当先压缩或缩放,再回来转换。
动图与 SVG
GIF 动图会被完整读成 Base64,帧数越多、时长越长,字串越大,内联后页面要一次性解析全部数据,动画播放也可能变得不流畅。SVG 同样会被 Base64 编码,原本可读、可搜索、可被压缩的矢量源码会变成一段不可读的字符,既不方便修改,也失去了源码形态下的压缩优势。需要保留 SVG 的可维护性时,应当直接内联 SVG 标签或使用独立文件。
文件类型与损坏文件
工具只按文件选择器提供的 MIME 类型判断,不会解码图片内容。因此把文本文件改成 .png 后缀再选中的情况,仍可能被当作图片读取并生成字串,但预览会显示空白或损坏图标。遇到预览异常时,先确认文件本身能否在系统看图工具中打开。浏览器不支持的格式(例如部分相机直出的 RAW)同样无法预览,即使字串生成了也没有使用价值。
敏感图片不要这样处理
虽然转换完全在本机完成,但 Base64 只是编码,不是加密,任何人都能把字串还原成原图。把身份证、合同、票据、内部设计稿转成 Base64 再贴进聊天工具、工单系统或代码仓库,等于把原图公开传播。这类内容不建议用内联方式处理;确实需要传输时,应当使用受控的存储与权限机制,并在用完后清理剪贴板与下载目录。
复制失败与超长文本
浏览器剪贴板接口在部分环境下会被限制,尤其是页面以本地文件方式打开、或权限被策略拦截时。复制失败不会丢失结果,状态栏会提示手动全选文本框内容复制。字串很长时,部分编辑器粘贴会明显变慢,建议先粘到纯文本编辑器里,再分次粘贴到目标位置,避免一次性卡住界面。