当前位置：首页 > 文章列表 > Golang > Go教程 > Golang图片上传与缩略图生成教程

Golang图片上传与缩略图生成教程

2026-01-17 14:19:01 0浏览收藏

欢迎各位小伙伴来到golang学习网，相聚于此都是缘哈哈哈！今天我给大家带来《Golang图片上传处理及缩略图生成教程》，这篇文章主要讲到等等知识，如果你对Golang相关的知识非常感兴趣或者正在自学，都可以关注我，我会持续更新相关文章！当然，有什么建议也欢迎在评论留言提出！一起学习！

需先调用 r.ParseMultipartForm(maxMemory)，maxMemory 建议设为 32<<20（32MB），否则大文件会耗尽内存或全部写入磁盘；漏调用或传 0 将导致 r.MultipartForm.File 为 nil 或性能严重下降。

如何在Golang中实现图片上传与处理_Golang图片存储与缩略图生成示例

如何用 `net/http` 接收 multipart 图片上传

Go 标准库原生支持 multipart/form-data，不需要额外依赖。关键点是调用 r.ParseMultipartForm 并限制内存缓冲大小，否则大文件会直接吃光内存。

常见错误：漏掉 ParseMultipartForm 就直接读 r.MultipartForm.File，结果返回 nil；或传入 0 导致全部写入磁盘（慢且不可控）。

maxMemory 建议设为 32 （32MB），足够覆盖多数头像/商品图
必须检查 err，上传中断、字段名错误、超限都会在这里报错
用 formFile 比手动遍历 MultipartForm.File 更简洁，但只适用于单文件字段

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    err := r.ParseMultipartForm(32 

用 golang.org/x/image/draw 生成等比缩略图
标准库不带图像处理能力，x/image 是官方维护的扩展包，比第三方更轻量、更新更及时。缩略图核心是「等比裁剪」还是「等比缩放」——前者保画质但可能丢内容，后者保完整但可能留白。
容易踩的坑：直接用 draw.CatmullRom 缩放到任意尺寸会导致模糊；没关闭源图 image.Image 的底层 reader；忽略 Alpha 通道导致 PNG 透明背景变黑。

先用 jpeg.Decode 或 png.Decode 解码，根据 header.Header.ContentType 判断格式
计算目标尺寸时，用 float64 运算再转 int，避免整数除法截断
目标 RGBA 图像必须用 image.NewRGBA 显式创建，不能复用原图矩形

func generateThumbnail(src image.Image, width, height int) *image.RGBA {
    bounds := src.Bounds()
    srcW, srcH := bounds.Max.X, bounds.Max.Y
    scale := float64(width) / float64(srcW)
    if float64(height)/float64(srcH) 

保存缩略图时如何保持原始格式与质量
用户上传的是 JPEG 还是 PNG，缩略图最好也用相同格式输出，否则可能破坏透明度或引入压缩失真。Go 的 image/jpeg 和 image/png 包都支持参数控制，但接口不统一。
典型问题：用 jpeg.Encode 保存 PNG 源图，结果透明区域全变黑；对 PNG 强行设 jpeg.Options{Quality: 95} 报错；没设置 png.Encoder.CompressionLevel 导致文件过大。

从原始 header.Header.Filename 或解码后类型判断格式，不要只看 Content-Type
JPEG 质量建议设为 85，平衡体积与观感；PNG 用 png.BestCompression 即可
写文件前确保目录存在：os.MkdirAll("./thumbnails", 0755)

func saveImage(img image.Image, path string, format string) error {
    f, _ := os.Create(path)
    defer f.Close()
    switch format {
    case "jpeg", "jpg":
        return jpeg.Encode(f, img, &jpeg.Options{Quality: 85})
    case "png":
        return png.Encode(f, img)
    default:
        return fmt.Errorf("unsupported format: %s", format)
    }
}