如何在 Go 中将 SVG 渲染为 PNG 或 JPEG 图像-Golang-PHP中文网

如何在 Go 中将 SVG 渲染为 PNG 或 JPEG 图像

本文介绍使用纯 go 库（oksvg + rasterx）将 svg 内容无依赖地渲染为高质量 png/jpeg 位图，涵盖文件读取、缩放适配、rgba 图像生成与编码保存全流程。

本文介绍使用纯 go 库（oksvg + rasterx）将 svg 内容无依赖地渲染为高质量 png/jpeg 位图，涵盖文件读取、缩放适配、rgba 图像生成与编码保存全流程。

在 Go 生态中，ajstarks/svg 等库擅长生成 SVG 字符串或写入 .svg 文件，但其本身不具备光栅化（rasterization）能力——即无法直接将 SVG 转为 PNG/JPEG。要完成该任务，需引入支持 SVG 解析与绘制的渲染库。推荐使用 oksvg + rasterx 组合：前者负责解析 SVG 文档并提取绘图指令，后者提供高性能抗锯齿光栅化器，二者均为纯 Go 实现，无需系统依赖（如 Cairo、ImageMagick 或系统级二进制）。

以下是一个完整、可运行的示例，将输入 SVG 文件（in.svg）渲染为 512×512 像素的 PNG：

package main

import (
    "image"
    "image/jpeg"
    "image/png"
    "os"

    "github.com/srwiley/oksvg"
    "github.com/srwiley/rasterx"
)

func main() {
    const width, height = 512, 512

    // 1. 打开 SVG 源文件
    in, err := os.Open("in.svg")
    if err != nil {
        panic("failed to open input SVG: " + err.Error())
    }
    defer in.Close()

    // 2. 解析 SVG 并创建可绘制图标对象
    icon, err := oksvg.ReadIconStream(in)
    if err != nil {
        panic("failed to parse SVG: " + err.Error())
    }

    // 3. 设置目标画布尺寸（自动缩放与居中）
    icon.SetTarget(0, 0, float64(width), float64(height))

    // 4. 创建 RGBA 位图缓冲区
    rgba := image.NewRGBA(image.Rect(0, 0, width, height))

    // 5. 使用 rasterx 进行高质量抗锯齿绘制
    scanner := rasterx.NewScannerGV(width, height, rgba, rgba.Bounds())
    dasher := rasterx.NewDasher(width, height, scanner)
    icon.Draw(dasher, 1) // scale=1 表示 1:1 渲染（已由 SetTarget 控制尺寸）

    // 6. 保存为 PNG（或替换为 JPEG）
    out, err := os.Create("out.png")
    if err != nil {
        panic("failed to create output file: " + err.Error())
    }
    defer out.Close()

    if err := png.Encode(out, rgba); err != nil {
        panic("failed to encode PNG: " + err.Error())
    }
}

✅ 若需导出 JPEG：只需将 png.Encode(...) 替换为：
if err := jpeg.Encode(out, rgba, &jpeg.Options{Quality: 90}); err != nil {
    panic(err)
}
其中 Quality 取值范围为 0–100（推荐 85–95 以平衡质量与体积）。

⚠️ 注意事项：