如何在 Go 中拼接多个图像（水平/垂直合并 PNG/JPEG）-Golang-PHP中文网

如何在 go 中拼接多个图像（水平/垂直合并 png/jpeg）

本文详细讲解如何使用 Go 标准库（image、draw）将多张 PNG 或 JPEG 图像拼接为一张大图，支持水平或垂直布局，并提供完整可运行示例、边界处理说明及常见注意事项。

本文详细讲解如何使用 Go 标准库（`image`、`draw`）将多张 PNG 或 JPEG 图像拼接为一张大图，支持水平或垂直布局，并提供完整可运行示例、边界处理说明及常见注意事项。

在 Go 中拼接图像本质上是内存中图像绘制操作：先创建一块足够大的空白画布（*image.RGBA），再将源图像按指定位置逐个绘制其上。整个过程不依赖第三方图形库，仅需标准库 image、image/draw、image/jpeg、image/png 和 os 即可完成。

✅ 基础拼接逻辑（水平拼接示例）

假设要将 img1.jpg 和 img2.jpg 从左到右水平拼接，关键步骤如下：

使用Go语言搭建家庭相册系统-相关课件

下载

解码两张图像，获取其尺寸（Bounds().Dx() 为宽，Bounds().Dy() 为高）；
计算目标画布尺寸：宽度为两图之和，高度取二者最大值（避免裁剪）；
创建新 RGBA 画布；
用 draw.Draw 分别将原图绘制到画布的对应区域（注意源图 src 的 image.Point{0,0} 与目标矩形 dst 的对齐关系）；
编码保存结果（根据扩展名选择 jpeg.Encode 或 png.Encode）。

以下是完整、健壮的实现代码（含错误处理与垂直拼接扩展）：

package main

import (
    "image"
    "image/color"
    "image/draw"
    "image/jpeg"
    "image/png"
    "os"
    "path/filepath"
)

// ConcatHorizontal 水平拼接多张图像（左→右），高度自适应为最大高度
func ConcatHorizontal(images []image.Image) *image.RGBA {
    if len(images) == 0 {
        return nil
    }

    // 计算总宽度和最大高度
    totalWidth := 0
    maxHeight := 0
    for _, img := range images {
        b := img.Bounds()
        totalWidth += b.Dx()
        if h := b.Dy(); h > maxHeight {
            maxHeight = h
        }
    }

    // 创建目标画布：(0,0) → (totalWidth, maxHeight)
    dstRect := image.Rect(0, 0, totalWidth, maxHeight)
    dst := image.NewRGBA(dstRect)

    // 逐张绘制，x 偏移累积
    xOffset := 0
    for _, src := range images {
        b := src.Bounds()
        dstRect := image.Rect(xOffset, 0, xOffset+b.Dx(), b.Dy())
        draw.Draw(dst, dstRect, src, b.Min, draw.Src)
        xOffset += b.Dx()
    }

    return dst
}

// ConcatVertical 垂直拼接（上→下），宽度自适应为最大宽度
func ConcatVertical(images []image.Image) *image.RGBA {
    if len(images) == 0 {
        return nil
    }

    totalHeight := 0
    maxWidth := 0
    for _, img := range images {
        b := img.Bounds()
        totalHeight += b.Dy()
        if w := b.Dx(); w > maxWidth {
            maxWidth = w
        }
    }

    dstRect := image.Rect(0, 0, maxWidth, totalHeight)
    dst := image.NewRGBA(dstRect)

    yOffset := 0
    for _, src := range images {
        b := src.Bounds()
        dstRect := image.Rect(0, yOffset, b.Dx(), yOffset+b.Dy())
        draw.Draw(dst, dstRect, src, b.Min, draw.Src)
        yOffset += b.Dy()
    }

    return dst
}

func main() {
    // 1. 加载图像（支持 JPEG/PNG）
    paths := []string{"test1.jpg", "test2.png"}
    var imgs []image.Image

    for _, p := range paths {
        f, err := os.Open(p)
        if err != nil {
            panic(err)
        }
        defer f.Close()

        img, format, err := image.Decode(f)
        if err != nil {
            panic(err)
        }

        // 转换为 RGBA（确保像素格式统一，避免 draw.Draw 兼容性问题）
        bounds := img.Bounds()
        rgba := image.NewRGBA(bounds)
        draw.Draw(rgba, bounds, img, bounds.Min, draw.Src)

        imgs = append(imgs, rgba)
        println("Loaded", p, "as", format, bounds)
    }

    // 2. 拼接（水平）
    result := ConcatHorizontal(imgs)
    if result == nil {
        panic("no images to concat")
    }

    // 3. 保存为 JPEG
    outFile, _ := os.Create("concatenated.jpg")
    defer outFile.Close()
    jpeg.Encode(outFile, result, &jpeg.Options{Quality: 90})
    println("Saved concatenated.jpg")
}

⚠️ 注意事项与最佳实践

格式一致性：image.Decode 返回的可能是 *image.NRGBA、*image.YCbCr 等类型，直接绘制可能因颜色模型不匹配导致异常。建议统一转为 *image.RGBA（如示例中 draw.Draw(rgba, ..., img, ...) 步骤）；
边界对齐：draw.Draw(dst, dstRect, src, srcMin, op) 中：
- dstRect 是目标画布上的绘制区域；
- srcMin 是源图像的起始点（通常为 src.Bounds().Min，即 {0,0}）；
- 若 dstRect.Size() != src.Bounds().Size()，会自动缩放（非本例需求），因此务必保证尺寸匹配或显式裁剪；
内存安全：大图拼接（如百张 4K 图）会占用显著内存，生产环境建议流式处理或分块拼接；
透明通道处理：PNG 含 Alpha 时，draw.Src 模式会保留透明度；若需背景填充（如白底），可先用 draw.Draw(dst, dst.Bounds(), &image.Uniform{color.White}, image.Point{}, draw.Src) 清屏；
文件扩展名与编码器：保存时请根据目标格式调用 jpeg.Encode 或 png.Encode，勿混用。