如何使用Python CairoSVG库将SVG100%缩放转为A4/Letter标准尺寸PDF

cairosvg.svg2pdf()的output_width、output_height参数默认接收无单位的CSS像素值（渲染基准为96DPI），直接传入毫米数值（如210、297）会被识别为对应像素值，远小于A4/Letter的实际物理尺寸，最终生成的PDF页面规格自然不符合要求。

方法1：直接传入带物理单位的参数（最简便） #

CairoSVG支持传入带标准CSS单位的字符串作为尺寸参数，无需手动换算像素，直接传入毫米单位的目标尺寸即可，参考代码：

import cairosvg

# A4规格配置
OUTPUT_WIDTH = "210mm"
OUTPUT_HEIGHT = "297mm"

# US Letter规格替换为以下配置即可
# OUTPUT_WIDTH = "216mm"
# OUTPUT_HEIGHT = "279mm"

cairosvg.svg2pdf(
    url=self.svg_path,
    write_to=self.output_file,
    output_width=OUTPUT_WIDTH,
    output_height=OUTPUT_HEIGHT,
    scale=1  # 强制1:1渲染，禁止自动缩放适配
)

方法2：按DPI换算为像素值传参 #

如果需要用像素值精确控制渲染精度，按照CairoSVG默认96DPI的渲染基准，以1英寸=25.4毫米为换算标准，对应尺寸的像素计算公式为：
目标像素值 = 物理长度(mm) / 25.4 * 96
常用尺寸换算结果：

• A4：宽≈794px，高≈1123px
• US Letter：宽≈816px，高≈1056px

传参示例：

# A4 96DPI 像素值
width = 794
height = 1123

cairosvg.svg2pdf(
    url=self.svg_path,
    write_to=self.output_file,
    output_width=width,
    output_height=height,
    scale=1
)

• 生成PDF后可在阅读器的文档属性页确认页面尺寸，参数配置正确的情况下，打印时选择「实际大小」选项即可，无需手动调整缩放比例
• 如果SVG文件根节点自带固定width/height属性，建议先将其修改为和输出尺寸一致的物理单位值，同时保留正确的viewBox属性，避免内容渲染错位、拉伸
• 不需要额外传入fit参数，默认值可能导致内容自动缩放留边，设置scale=1即可保证100%比例渲染

内容的提问来源于stack exchange，提问作者Ramchandra Shahi Thakuri