Base64 转文件:还原字节并正确命名下载文件
Admin ·
Base64 转文件工具还原 Base64 字符串所表示的字节,并准备可下载的文件。粘贴编码值、填写文件名,点击“解码文件”,核对显示的大小,再下载保存。如果原始编码的内容是图片、文档、压缩包或其他二进制数据,结果就可以是对应的文件。
解码成功只回答一个问题:输入是否能按照本工具的规则表示一组字节?它不识别原始格式、不修复缺失内容,也不证明文件安全。本指南说明可接受的输入形式,以及如何选择合适的文件名、发现不完整的输入。
从编码值还原一个文件
将完整内容粘贴到“Base64 输入”,在“文件名”中填写想使用的名称,再点击“解码文件”。验证通过后,“解码大小”会显示字节数和清理后的文件名,并出现“下载文件”按钮。下载是另一个操作;仅解码不会将文件保存到设备。
可以先用 SGVsbG8= 和文件名 hello.txt 做个小测试。解码结果是拼出 Hello 的五个字节,不会额外添加换行。处理实际文件时,来源应能提供预期类型和大小。此工作区接收粘贴的文本,不提供文件上传、远程链接读取或多个编码文件的批量输入。
- 复制完整编码值,不要带上 JSON 引号或日志旁的标签。
- 选择与原始内容匹配的扩展名。
- 保存前,将解码字节数与发送方提供的预期大小比较。
RFC 4648:Base16、Base32 与 Base64 数据编码MDN:HTMLAnchorElement.download
Base64 表示字节,不决定字节的含义
通常每三个原始字节用四个 Base64 符号表示。对于包含 n 个字节的非空文件,带填充的表示共有 4 × ceil(n / 3) 个符号,不计数据网址头部及额外空白。单字节文件也需要四个带填充的符号,因此并非每种大小都恰好增加三分之一。Base64 改变表示方式,不压缩数据。
解码器保留原始字节,包括零字节和不能作为文本阅读的数值,不会将 PDF 或图片重新解释为 Unicode 文本。若原始字节采用 UTF-8 文本编码,合适的文本编辑器可以显示它;其他字符编码可能需要更改编辑器设置。若只是对一段文字编码或解码,单独的 Base64 编码与解码工具可能更合适。
| Base64 | 还原的内容 | 字节数 |
|---|---|---|
| Zg== | 字母 f | 1 |
| Zm8= | 字母 fo | 2 |
| Zm9v | 字母 foo | 3 |
| AP8= | 十六进制二进制字节 00 FF | 2 |
RFC 4648:Base16、Base32 与 Base64 数据编码MDN:Window.atob()MDN:Blob 构造函数
一个值只使用一种受支持的字母表
标准 Base64 使用字母、数字、加号和斜杠。URL 安全 Base64 用连字符和下划线替代最后两个符号。ToolMellow 接受任意一种,并在解码前将 URL 安全形式规范化。正确的末尾填充可以保留;如果剩余符号能组成有效的最后一组,也可以省略填充。
不要在同一个值中混用两种字母表的专属符号。例如,//8= 和 __8= 都还原为两个值为 255 的字节,而 _/8= 会被拒绝。URL 安全不代表可以粘贴整个网页地址:工具不会获取链接、提取查询参数或拆分 JSON Web Token。请先取得实际的编码字段。
数据网址头部包裹内容,不转换内容
支持的形式是 data:...;base64,payload,分隔逗号之前的头部不能包含空格或逗号。data 前缀和 base64 标记不区分大小写。例如,data:text/plain;base64,SGVsbG8= 与不带头部的编码值产生相同的五个字节。声明的媒体类型会被丢弃,不决定下载名称或输出内容类型。
并非所有数据网址都使用 Base64。data:text/plain,Hello 不在此工具支持的形式内。工具也不对载荷执行百分号解码:%3D 在这里仍是无效内容,不会自动变成等号。JSON 字符串、转义斜杠或经过百分号编码的网址,可能需要先按照其外层表示规则提取或解码,才能得到原本的 Base64 值。只有来源格式要求时才这样处理。
| 输入形式 | 工具如何处理 | 需要检查什么 |
|---|---|---|
| SGVsbG8= | 直接解码载荷 | 使用完整编码值。 |
| data:text/plain;base64,SGVsbG8= | 移除支持的头部再解码 | 头部不会指定文件名或转换字节。 |
| data:text/plain,Hello | 拒绝非 Base64 形式 | 为这种数据网址选择相应的解码器。 |
| data:text/plain;base64,SGVsbG8%3D | 拒绝载荷中的百分号转义 | 检查是否需要先去除外层 URL 编码。 |
正确填充不只是末尾有等号
当原始字节数不能被三整除时,填充会补齐最后一组。Zg== 和不带填充的 Zg 都表示一个字节;Zm8= 与 Zm8 表示两个字节。末组只有一个符号时,无法表示完整字节。位于中间的等号、过多填充或与末组不相符的填充都会被拒绝。
最后一个符号中未使用的位也必须为零。有些宽松的解码器能从 Zh== 得到字节,但本工具会拒绝它;字母 f 的规范编码是 Zg==。同样,Zm9= 会被拒绝,而 Zm8= 可以接受。工具解码后会重新编码字节,并与规范化、去掉填充后的输入比较。这检查的是表示是否规范,不是原文件是否正确。
去掉头部和空白之前计算输入长度
输入最多为 16777216 个 UTF-16 代码单元,在去除首尾空白、数据网址头部或支持的内部空白之前计数。普通 Base64 符号占一个代码单元。解码结果不能为空,也不能超过 12582912 字节,即 12 MiB。这些是接受输入和输出的上限,不代表标签页只会占用这么多内存。
不带头部的 16777216 个有效符号可以表示完整的 12 MiB 输出容量。添加头部或换行会消耗同一份输入额度,可能使原本有效的载荷超长。超限编辑会被整体拒绝:之前的输入保留,旧的下载结果清除,并显示错误。工具不会接受此次编辑被截短后的开头部分。请使用原始数据源或适合较大文件的处理方式,不要靠截断编码文本来满足限制。
| 限制项 | 准确上限 | 实际影响 |
|---|---|---|
| 原始输入 | 16777216 个 UTF-16 代码单元 | 清理之前,头部和空白都计入长度。 |
| 解码结果 | 12582912 字节,即 12 MiB | 输出还必须至少包含一个字节。 |
| 文件名字段 | 120 个 UTF-16 代码单元 | 文件名长度与文件内容的限制分别计算。 |
| 同时处理 | 工作区中的一个编码值 | 没有批量队列或已保存任务历史。 |
清理复制内容时不要改变有效数据
首尾空白会被去除。载荷内部只删除 ASCII 空格、制表符、换行符、回车符和换页符,所以普通按行折分的 Base64 可以使用,但内部的垂直制表符或不换行空格不会被忽略。从有排版的文档复制内容时,即使意外字符很难看见,也可能导致失败。
尽量从原始来源取得纯文本副本。不要为了让错误消失而替换所有陌生字符或随意删除标点:加号或斜杠可能是有效 Base64 数据。增加等号同样不能恢复缺失符号。通用错误消息不指出具体哪个字符失败,因此应依次检查头部、字母表、填充及原始长度。
按还原后的内容选择文件名
默认文件名是 decoded.bin。工具会将部分控制字符及路径中不允许的标点替换成下划线,去除特定的首尾点号和空格,修剪名称,并限制为 120 个 UTF-16 代码单元。清理后为空时,回退到 decoded.bin。页面显示的是建议下载名称;浏览器和操作系统的规则仍可能影响最终保存的名称。
扩展名向其他软件提示内容类型,不改变内容本身。将任意字节命名为 photo.png 不会使其变成 PNG。同样,.pdf 不会修复损坏文档,.zip 也不会压缩数据。类型不明时,请向发送方确认。此工具没有格式检测器,也不会将数据网址中的媒体标签与字节内容比对验证。
下载保留二进制内容
解码字节数组会成为内容类型为 application/octet-stream 的 Blob。即使数据网址声明 text/plain,或文件名扩展名选择 .png,仍使用这个二进制类型。“下载文件”会创建临时对象网址,请求浏览器使用建议名称下载。工作区本身不会预览、打开或执行还原后的文件。
每次点击下载,都会安排在 60000 毫秒后撤销该次临时对象网址。这项清理不会删除已保存的文件,也不会移除页面上的解码结果。结果仍可用时,可以再次点击“下载文件”。浏览器可能询问保存位置,或使用已有下载设置;页面显示结果并不证明保存已经完成。
MDN:Blob 构造函数MDN:URL.createObjectURL()MDN:HTMLAnchorElement.download
了解哪些编辑会保留结果
更改 Base64 输入会清除上一次结果和旧验证错误。超限编辑是接受新文本的例外:之前的输入保留,旧结果清除,并显示错误。点击“解码文件”也会在验证前清除旧结果。因此,解码失败时,不会仍提供旧文件,让人误以为它对应新输入。
成功解码后修改“文件名”,会保留相同字节并更新建议下载名称。仅改名不需要再次解码。处理采用同步方式,没有进度百分比或取消按钮。工作区没有已保存任务历史;重新加载或离开页面前,请保留原始编码值或核实后的下载文件。
区分编码错误与文件本身的问题
验证错误表示输入没有通过某项工具检查,不一定说明原文件已损坏。先确认复制的是完整编码值,而不是网址、带引号的字段或整行日志,再检查大小、不支持的空白、混用字母表及填充。如果无法与来源核对,请重新索取副本,不要凭猜测修改。
成功解码仍可能生成不完整或无法使用的文件。丢失整组 Base64 符号后,语法可能依然有效;字节本身也可能已经是损坏、加密或不支持的内容。请将显示的字节数与独立提供的预期大小比较。若发送方通过可信渠道提供哈希值,可使用单独的哈希工具比较内容;此工作区不计算或验证哈希。
| 现象 | 可能原因 | 建议下一步 |
|---|---|---|
| 通用验证错误 | 输入过长、形式或符号不支持、填充无效 | 检查原始完整值及所列输入规则。 |
| 文件已下载却打不开 | 扩展名错误、字节缺失、内容加密或格式不支持 | 向发送方确认原始格式和预期大小。 |
| 改名后文件仍无法使用 | 改名没有改变字节 | 确认来源类型后,再使用真正的格式转换器。 |
| 编辑后没有“下载文件”按钮 | 旧结果已清除 | 下载前重新验证所需输入。 |
本地解码不等于验证来源可信
验证、解码和下载准备均在当前浏览器标签页中进行。已实现的流程不会将粘贴的 Base64 或还原文件上传到解码服务器。加载网站仍涉及常规页面资源,站点分析功能也可能发起独立请求。这是在描述处理路径,并不承诺零网络流量或永久离线可用。
Base64 是可逆编码,不是加密或数字签名。解码不能验证发送方身份、扫描恶意软件或判断是否适合打开文件。请使用可信来源的内容,并按平常流程核实。本地处理也不承诺安全擦除浏览器内存,或删除你已保存的文件。
常见问题
如何把 Base64 保存成文件?
粘贴完整值,填写文件名,再点击“解码文件”。核对解码字节数后点击“下载文件”。解码和保存是两个操作。
支持 URL 安全 Base64 或省略填充吗?
支持,前提是输入符合规则。标准和 URL 安全形式都可使用,允许正确填充或不带填充。混用专属符号、无效末组及非零填充位会被拒绝。
数据网址会决定下载文件的类型吗?
不会。工具去除支持的 Base64 头部,忽略媒体标签。Blob 使用 application/octet-stream,文件名由你选择。工具不验证文件格式。
输入最多能有多大?
清理前最多 16777216 个 UTF-16 代码单元,包含头部和空白。解码结果必须非空,且不超过 12582912 字节,即 12 MiB。
粘贴超长文本会怎样?
整次超限编辑会被拒绝,之前的输入保留并显示错误,旧下载结果清除。工具不会悄悄保留此次文本被截短后的开头部分。
Base64 内部可以有哪些空白?
载荷中的 ASCII 空格、制表符、换行符、回车符和换页符会被删除。其他内部空白,包括不换行空格和垂直制表符,会被拒绝。首尾空白另行修剪。
其他解码器接受 Zh==,为什么这里拒绝?
它未使用的填充位不为零。工具要求规范化后这些位符合规范;表示字母 f 对应字节的可接受填充形式是 Zg==。
把 .bin 改为 .png 会转换文件吗?
不会。更改扩展名只会更改建议名称。请选择匹配原始字节内容的扩展名;工具不会创建新的图片或文档格式。
可以不重新解码,只给结果改名吗?
可以。编辑文件名会保留解码字节并更新建议下载名称。编辑 Base64 输入才会清除旧结果。
解码成功后仍可能得到损坏文件吗?
可能。有效 Base64 可以表示不完整、损坏、加密或不支持的内容。若有独立提供的预期大小或可信哈希值,请进行比较;此工作区不检查文件完整性。
输入和解码字节会被上传吗?
已实现的解码器在浏览器标签页处理它们,没有上传步骤。页面仍可加载资源并发起普通站点请求,所以本地解码不代表整个网站没有网络请求。
六十秒后文件会消失吗?
不会。系统会安排在六十秒后清理此次下载创建的临时对象网址,不会删除已保存文件,也不会使保留的解码结果过期。再次点击下载可以创建新的对象网址。