Go的image.DecodeConfig报“unknown image format”是因为未显式导入对应格式解码器，需用_空白导入如_ "image/png"；解析data URI须截取逗号后base64内容；DecodeConfig已轻量但依赖完整格式支持，WebP动图需用x/image/webp包获取动画信息；输入损坏时config可能为nil且无error，须校验Width>0。
直接用 image.DecodeConfig 但报 “unknown image format”
这不是你代码写错了，而是标准库压根没注册对应格式的解码器。Go 的 image.DecodeConfig 不会自动识别文件类型——它依赖已注册的解码器，而这些解码器需要显式导入。比如读 PNG 文件却没加 _ "image/png"，就会返回 unknown image format 错误。
常见遗漏点：
- 只导入了
"image"，没空白导入（_）任何具体格式包 - 误以为文件后缀（如
.jpg）能触发自动匹配，实际只看文件头（magic bytes）和已注册格式 - 在子模块或 vendor 环境中，格式包被裁剪掉（如某些精简版构建工具会剔除未显式引用的包）
正确做法：确保至少导入你要支持的格式，例如：
import (
"image"
_ "image/jpeg"
_ "image/png"
_ "image/gif"
_ "golang.org/x/image/webp" // 需额外 go get
)
从 data:image/xxx;base64,... 提取宽高失败
前端 canvas 的 toDataURL() 返回的是完整 data URI 字符串，不能直接丢给 base64.StdEncoding.DecodeString。逗号前的部分（如 data:image/png;base64,）不是 base64 编码内容，硬解会报 illegal base64 data at input byte x。
立即学习“go语言免费学习笔记（深入）”；
安全截取 base64 数据段的方法：
- 用
strings.IndexByte(s, ',')找第一个逗号位置，再切片：s[commaIndex+1:] - 不要用
strings.Split(s, ",")—— 某些 base64 数据里可能含 URL 编码逗号（极少见但非不可能） - 截完后建议做一次
base64.RawStdEncoding.DecodeString或补等号对齐，避免 padding 缺失导致解码失败
之后把解码后的字节流丢给 bytes.NewReader，再传入 image.DecodeConfig 即可。
想跳过解码、只读文件头快速拿宽高
如果你只关心尺寸、不打算后续解码或渲染，image.DecodeConfig 已经是最轻量的方式——它内部只读几十到几百字节，不会加载整张图。但注意：它仍需完整格式支持，比如 WebP 动图的 VP8X 头部解析就依赖 golang.org/x/image/webp 包。
手动解析文件头虽快，但风险高：
- JPEG 宽高不在固定偏移（SOI → APP0/APP1 → SOF0，需跳过可选 marker）
- PNG 宽高在第 17 字节起的 8 字节，但前提是先验证前 8 字节是否为
\x89PNG\r\n\x1a\n - GIF 宽高在第 6 字节起的 4 字节，但需确认是 GIF87a 还是 GIF89a
- WebP 必须检查 VP8X chunk 是否存在且动画位（bit 2）置 1，否则静态 VP8 块头部结构完全不同
除非你有极端性能要求且只处理单一格式，否则别自己 parse header。用标准库 + 正确导入更稳。
WebP 动图被当成静态图，宽高只读第一帧
image.DecodeConfig 对 WebP 默认只返回整个容器的逻辑尺寸（即画布宽高），不管它是不是动图。而动图的每一帧可能有不同位置/尺寸（带 offset 的 frame），但 DecodeConfig 不暴露帧信息。
若业务需区分动/静 WebP 或获取首帧真实尺寸，必须：
- 引入
golang.org/x/image/webp - 用
webp.DecodeConfig替代image.DecodeConfig（它会返回*webp.Config，含Anim字段） - 或者先用
webp.Decode解出第一帧*image.RGBA，再调Bounds().Dx()/Dy()
注意：webp.DecodeConfig 不在标准库，且它的 Anim 字段是 bool 类型，仅表示“是否为扩展 WebP 格式”，不保证所有帧都有效——真正的帧解析还得靠完整解码。
最易被忽略的一点：即使你导入了所有格式包，如果输入数据是损坏的（比如截断的 JPEG、少几个字节的 PNG），DecodeConfig 仍可能返回 nil config + nil error。务必检查返回的 config.Width > 0，而不是只判 error。
