Go中文件格式转换应采用流式处理+格式感知+生命周期可控方案，优先使用golang.org/x/image子包（如webp、bmp）实现图片转换，避免命令行调用或全量加载；GBK↔UTF-8转换必须用gbk.Decoder.Bytes和gbk.Encoder.Bytes，注意参数类型与BOM处理，Decoder/Encoder不线程安全需按goroutine新建。
Go 里做文件格式转换，别拼接命令行调用外部工具，也别把整份文件 load 到内存再硬转——这两种做法在并发或大文件场景下，不是卡死就是 OOM。真正高性能的中间件，核心是流式处理 + 格式感知 + 生命周期可控。
golang.org/x/image 是图片格式转换的唯一可靠路径
标准库 image 包只注册解码器，不提供编码器实现；image/jpeg.Encode 和 image/png.Encode 虽可用，但 WebP、BMP、AVIF 等必须额外引入。统一用 golang.org/x/image 子包最稳：
- 按需导入：
golang.org/x/image/webp、golang.org/x/image/bmp等，避免全量依赖 - 读取一律用
image.Decode，它自动识别魔数，不用自己bytes.Equal(header[:3], []byte{0x89, 0x50, 0x4E})判断格式 - 写入前必须检查颜色模型：JPEG 不支持 Alpha，
image.NRGBA直接写会黑边；得先合成到白底：draw.Draw(dst, dst.Bounds(), src, src.Bounds().Min, draw.Src) -
webp.Encode的*webp.Options中，Lossy必须设为true才启用Quality参数，否则质量恒为默认值
binary.Read 不能直接读网络流或大文件头
想解析自定义二进制协议（比如日志包、设备上报帧）时，binary.Read 不是拿来就用的“万能解包函数”。它假设输入是完整、对齐、无粘包的数据块：
- TCP 连接必须先分包：读前 4 字节
uint32得到包长，再用io.ReadFull(r, buf[:pkgLen])拿完整 payload - 结构体字段必须全导出（首字母大写），且类型定长：
int→int32，string→[64]byte，否则 panic 或错位 - 字符串字段要手动 trim：
bytes.TrimRight(buf[:n], "\x00")，再转string()；别指望binary.Read自动处理变长内容 - 校验和计算必须在 payload 完整读入后立刻做，用
crc16.Checksum(payloadBuf[:len(payloadBuf)-2], table)，别拼bytes.Buffer，它的Bytes()可能含冗余底层数组
gbk.Decoder.Bytes 和 gbk.Encoder.Bytes 容易反向传参
UTF-8 ↔ GBK 转换不是类型强转，而是解码→Unicode→编码三步。用错方向或参数类型，结果要么 panic，要么静默乱码：
立即学习“go语言免费学习笔记（深入）”；
- GBK → UTF-8：调
gbk.Decoder.Bytes(gbkBytes)，gbkBytes是原始[]byte，返回合法 UTF-8 字节切片；别传string(gbkBytes) - UTF-8 → GBK：调
gbk.Encoder.Bytes([]byte(utf8Str))，必须传[]byte，不是utf8Str本身；emoji 或生僻字无 GBK 码位时返回encoding.ErrUnsupported - BOM 必须提前跳过：GBK 文件若开头有
0xEF 0xBB 0xBF（UTF-8 BOM），gbk.Decoder会报encoding.InvalidUnreadableError - Decoder/Encoder 实例不线程安全，别缓存复用；高频场景用
sync.Pool或 per-goroutine 新建
doc → docx 转换必须走 unioffice，但仅限小文件
github.com/unidoc/unioffice 是目前 Go 生态中唯一能实际打开并重写 .doc 文件的库，但它本质是逆向解析 OLE 复合文档结构，不是通用格式转换器：
- 不支持密码保护、宏、嵌入对象等复杂特性，遇到即 panic
- 内存占用高：一个 2MB .doc 文件解压后可能占 200MB 内存，不适合批量或并发处理
- 必须配合
github.com/antchfx/xmlquery解析内部 XML 结构，无法流式处理；读完整个文件才开始转换 - 生产环境建议：只用于后台离线任务，加超时控制（
context.WithTimeout），失败直接 fallback 到提示“格式不支持”
真正影响性能的从来不是算法，而是数据流动路径是否可控——是否在读取时就解码、是否在写入前就合成、是否让 GC 能及时回收图像引用。这些细节不显眼，但一漏就是线上 OOM 或乱码投诉。
