如何使用CairoSVG在Python3中获取SVG文件的尺寸或比例

你可以通过CairoSVG内置的解析能力，无需完整渲染输出文件，也不用自行解析XML，就能快速获取SVG的原始尺寸和宽高比。

1. 获取SVG尺寸的代码实现 #

方案1（轻量解析，推荐） #

仅解析SVG结构，不执行渲染，性能开销极低：

import cairosvg
from cairosvg.parser import Tree

def get_svg_dimensions(svg_file_path: str) -> tuple[float, float, float]:
    # 仅解析SVG结构
    svg_tree = Tree(url=svg_file_path)
    # 获取解析后的原始宽高，单位为像素
    width = svg_tree["width"]
    height = svg_tree["height"]
    # 计算宽高比
    aspect_ratio = width / height
    return width, height, aspect_ratio

方案2（版本兼容） #

如果你的CairoSVG版本较低不支持方案1，可以用以下兼容写法：

import cairosvg

def get_svg_dimensions_compatible(svg_file_path: str) -> tuple[float, float, float]:
    # 初始化PNG渲染流程，指定write_to为None不生成实际文件
    surface = cairosvg.svg2png(url=svg_file_path, write_to=None)
    # 从渲染上下文获取宽高
    width = surface.context.get_target().get_width()
    height = surface.context.get_target().get_height()
    return width, height, width / height

2. 转换环节直接完成缩放 #

拿到尺寸后你可以直接计算适配幻灯片预留空间的缩放比例，在调用转换方法时直接传入scale参数，一步完成转换+缩放，不需要后续处理PNG：

# 示例：幻灯片预留区域宽为960px，高为540px，可根据实际需求修改
TARGET_WIDTH = 960
TARGET_HEIGHT = 540

svg_w, svg_h, ratio = get_svg_dimensions("你的SVG文件路径.svg")
# 计算等比缩放的比例，保证SVG完全适配预留区域不裁切
scale = min(TARGET_WIDTH / svg_w, TARGET_HEIGHT / svg_h)

# 直接转换同时完成缩放
cairosvg.svg2png(
    url="你的SVG文件路径.svg",
    write_to="输出的PNG路径.png",
    scale=scale
)

注意事项 #

• 以上方法适配CairoSVG 2.0及以上版本，SVG中定义的em、pt、百分比等相对单位会自动转换为像素绝对值返回
• 如果不需要读取本地文件，可以把上述方法的url参数替换为bytestring参数，直接传入SVG的二进制内容进行解析

内容的提问来源于stack exchange，提问作者Martin Packer