使用说明与限制
怎样检查扩展名与文件头是否一致?
- 选择本机文件,工具会自动读取前 4 KiB 并生成结果;文件不会被执行或解压。这里读取的是二进制内容,不是仅查看文件名。
- 先看
type和mime,再结合extensionMatch与note判断是否需要进一步核验。 - 需要排查上传失败或下载异常时,可复制、下载检测 JSON;分享前注意结果包含本机文件名,但不包含完整文件内容。
检测结果各字段如何理解?
- type / mime
- 文件头匹配到的格式或容器类型,以及相应 MIME。支持常见图片、PDF、ZIP/GZIP/7z/RAR 和部分音视频容器,不是所有格式的完整数据库。
- extensionMatch
true表示扩展名在该格式的常见列表内;false表示不匹配;null表示缺少扩展名、尚未识别,或存在无法仅凭文件头判断的容器子类型,不能解释为“文件正常”。- headerHex
- 最多展示前 32 字节的十六进制内容,便于与格式规范对照;不是整个文件的十六进制转储。
- bytes / note
bytes是原文件总大小,不是实际读取量;note会说明检测边界或容器歧义。
示例:扩展名改成 JPG 的 PNG
89 50 4E 47 0D 0A 1A 0A这是 PNG 的常见起始标记。若文件名为 photo.jpg 而内容匹配此文件头,结果会提示 PNG 与扩展名不匹配。修改扩展名不会转换格式。页面“加载示例”只有演示文件头,不是可正常打开的完整图片。
为什么 DOCX 可能显示为 ZIP container?
DOCX、XLSX、PPTX、JAR、APK 等可以共享 ZIP 容器标记;本工具不解包检查内部文件,因此不能确认具体文档子类型。MP4、MOV、HEIF 等媒体容器也存在类似限制。未知格式不等于文件损坏,识别成功不等于文件完整或无病毒,安全检查仍需专门工具。