Python批量转换SVG为PNG与PDF的自动化脚本

实现批量转换的核心逻辑

cairosvg作为独立的SVG渲染模块，对外暴露svg2png与svg2pdf两个核心方法。它们接受XML文本字节流，直接写入目标二进制文件，无需依赖外部GUI软件。结合Python的os与io模块，可构建完整的自动化流水线。

环境准备与依赖安装

在运行脚本前，请确保终端满足以下基础条件：

• 操作系统已安装Python 3.6及以上版本（原生支持input()与print()函数对象）
• 通过命令行执行依赖安装：pip install cairosvg
• 待转换的.svg文件编码统一为UTF-8，避免解析断层

# -*- coding: utf-8 -*-
import cairosvg
import os

def get_valid_dir(prompt_msg, allow_create=True):
    """交互式获取合法目录路径"""
    while True:
        path = input(prompt_msg)
        if os.path.exists(path) and os.path.isdir(path):
            return path
        if allow_create:
            while True:
                choice = input("路径不存在，是否自动创建该目录？(Y/N) ")
                if choice.strip().upper() == "Y":
                    try:
                        os.makedirs(path, exist_ok=True)
                        if os.path.exists(path):
                            return path
                    except PermissionError:
                        print("权限不足，请更换路径或提升终端权限")
                elif choice.strip().upper() == "N":
                    break
        print("输入无效，请核对路径后重试")

def batch_export(src_folder, dst_folder, target_fmt):
    """执行批量格式转换"""
    print("任务启动，正在扫描源目录...")
    svg_list = [f for f in os.listdir(src_folder) if f.lower().endswith(".svg")]
    success_count = 0
    
    for svg_name in svg_list:
        file_abs = os.path.join(src_folder, svg_name)
        base = svg_name[:-4]
        ext_map = {"png": ".png", "pdf": ".pdf"}
        out_file = os.path.join(dst_folder, f"{base}{ext_map[target_fmt]}")
        
        try:
            with open(file_abs, "rb") as handle:
                raw_data = handle.read()
            
            if target_fmt == "png":
                cairosvg.svg2png(bytestring=raw_data, write_to=out_file)
            else:
                cairosvg.svg2pdf(bytestring=raw_data, write_to=out_file)
                
            print(f"已导出: {out_file}")
            success_count += 1
        except Exception as err:
            print(f"转换中断 [{svg_name}]: {err}")
            continue
    
    print(f"\n流程结束，累计成功导出 {success_count} 个文件")

if __name__ == "__main__":
    origin_dir = get_valid_dir("请输入SVG源文件所在目录: ")
    dest_dir = get_valid_dir("请输入转换结果输出目录: ", allow_create=True)
    
    while True:
        fmt_req = input("请选择导出格式 (输入 png 或 pdf): ").strip().lower()
        if fmt_req in ("png", "pdf"):
            break
        print("暂不支持其他格式，请重新输入")
        
    batch_export(origin_dir, dest_dir, fmt_req)

实际操作步骤

第1步：录入源与目标路径参数

目的：锁定读取范围与写入位置，防止误覆盖非目标盘符。 入口：双击运行脚本后弹出的首行终端光标。 动作：粘贴绝对路径或相对路径并回车。若目标盘为空且勾选允许创建，系统将递归建立文件夹结构。 重要参数：路径长度不超过Windows API限制的MAX_PATH（通常为260字符），建议避开系统保护区。 完成状态：控制台回显True路径指向的目录句柄即视为就绪。

第2步：指定导出格式并触发渲染

目的：根据下游业务需求切换cairosvg的处理管线。 入口：路径校验通过的第二个交互节点。 动作：键入png进入位图压缩通道，键入pdf进入矢量封装通道。 重要参数：格式名严格区分大小写，输入错误将触发重新请求而不破坏前置状态。 完成状态：控制台开始逐条打印已导出:日志，表明底层绘图引擎已进入工作队列。

第3步：执行后文件核对

目的：验证转换完整性与命名一致性。 入口：脚本执行完毕后返回的C:\Users\...>命令提示符。 动作：打开设定的输出目录，检查生成的位图/文档是否与原始SVG一一对应。 重要参数：同名冲突文件会被直接覆盖，首次使用前建议对关键资产执行手动备份。 完成状态：终端汇总提示累计成功导出 N 个文件且目标目录无残缺项，即代表任务闭环。

常见运行异常排查

• Traceback提示 ModuleNotFoundError：说明cairosvg未纳入当前虚拟环境。请在激活的终端内重新执行pip install cairosvg，注意Mac/Linux系统可能需先安装系统级Cairo头文件。
• EncodingWarning 或 乱码崩溃：部分老旧SVG文件夹杂GBK字符集。代码已强制采用rb模式读取二进制流绕过解码冲突，若仍报错请提前在编辑器中将文件另存为UTF-8格式。
• 权限拒绝 (PermissionError)：杀毒软件或文件系统只读属性拦截了写入请求。以管理员身份运行CMD/PowerShell，或将输出路径切换至桌面/临时文件夹。

方案总结

该脚本将矢量解析与目录管理解耦，通过标准化参数传递减少人工干预频次。开发者可在batch_export函数内叠加width/height像素缩放参数，或引入多线程池进一步压榨多核CPU性能。以上就是Python批量转换SVG格式为PNG与PDF的详细内容，更多关于Python自动化处理矢量图像的资料请关注本站其它相关文章！