如何在 Go 中向图像添加文字（支持中英文、数字与自定义字体）

本文介绍使用 go 语言在图像上绘制文本的主流方案，重点推荐成熟稳定的 `freetype-go` 库，并提供完整可运行示例，涵盖字体加载、坐标定位、颜色设置及抗锯齿渲染等关键步骤。

Go 标准库（如 image/draw、image/jpeg）本身不提供文字渲染能力——它只处理像素级绘图操作，而文字绘制需依赖字体解析、字形光栅化、UTF-8 编码映射及排版逻辑，因此必须借助第三方库。目前最成熟、广泛采用且持续维护的方案是 github.com/golang/freetype（原 freetype-go 的官方继承者，已迁移至 GitHub 并全面适配 Go modules）。

该库基于 FreeType C 库封装，支持 TrueType（.ttf）、OpenType（.otf）等主流字体格式，具备亚像素抗锯齿、多语言 Unicode 渲染（包括中文、日文、阿拉伯文等）、字号/角度/行距灵活控制等能力。

✅ 推荐使用方式（Go 1.16+）：

go get github.com/golang/freetype
go get golang.org/x/image/font/basicfont
go get golang.org/x/image/math/f64
go get golang.org/x/image/font/gofonts

? 完整示例：在 PNG 图像上绘制带阴影的中英文混合文本

package main

import (
    "image"
    "image/color"
    "image/draw"
    "image/png"
    "log"
    "os"

    "golang.org/x/image/font"
    "golang.org/x/image/font/basicfont"
    "golang.org/x/image/font/gofonts"
    "golang.org/x/image/font/inlinetext"
    "golang.org/x/image/font/sfnt"
    "golang.org/x/image/math/f64"
    "golang.org/x/image/vector"

    "github.com/golang/freetype"
    "github.com/golang/freetype/truetype"
)

func main() {
    // 1. 创建画布（RGBA）
    img := image.NewRGBA(image.Rect(0, 0, 800, 400))
    draw.Draw(img, img.Bounds(), &image.Uniform{color.RGBA{240, 245, 255, 255}}, image.Point{}, draw.Src)

    // 2. 加载字体（使用内置 Go 字体，或替换为本地 .ttf 文件）
    tt, err := truetype.Parse(gofonts.GothamRoundedMedium)
    if err != nil {
        log.Fatal(err)
    }

    // 3. 构建上下文
    c := freetype.NewContext()
    c.SetDPI(72)
    c.SetFontFace(truetype.FontFace{
        Face: tt,
        Size: 32,
        // 可选：设置 Hinting（字形微调）
        Hinting: font.HintingFull,
    })
    c.SetSrc(image.NewUniform(color.RGBA{40, 40, 40, 255}))
    c.SetDst(img)
    c.SetClip(img.Bounds())

    // 4. 绘制带偏移阴影的文字（模拟效果）
    shadowOffset := 2
    c.SetSrc(image.NewUniform(color.RGBA{200, 200, 200, 180}))
    c.DrawString("Hello 世界 123!", 100+shadowOffset, 200+shadowOffset)

    // 5. 绘制主文字
    c.SetSrc(image.NewUniform(color.RGBA{30, 30, 30, 255}))
    c.DrawString("Hello 世界 123!", 100, 200)

    // 6. 保存为 PNG
    out, err := os.Create("output.png")
    if err != nil {
        log.Fatal(err)
    }
    defer out.Close()

    if err := png.Encode(out, img); err != nil {
        log.Fatal(err)
    }

    log.Println("✅ 文本已成功绘制并保存为 output.png")
}

⚠️ 注意事项：

• 字体路径：若使用本地 .ttf 文件，请用 os.ReadFile("path/to/font.ttf") + truetype.Parse() 加载；
• 中文支持：确保所选字体包含对应 Unicode 区块（如 Noto Sans CJK、思源黑体），gofonts 仅含基础拉丁字符，中文需额外引入；
• 性能优化：高频绘制场景建议复用 *truetype.Font 和 freetype.Context，避免重复解析；
• 替代方案：github.com/disintegration/imaging + freetype 组合更易集成；纯纯轻量需求可考虑 github.com/oakmound/oak/v4/render/font（但生态较弱）。

总结：github.com/golang/freetype 是当前 Go 生态中事实标准的文字图像渲染方案——稳定、文档完善、社区活跃、兼容性好。只要正确加载字体并理解 DrawString(x, y) 的基线（baseline）坐标系（y 向下增长，原点在左下基线处），即可精准控制任意文本的视觉呈现。