Python中用Spire.Presentation无法替换SmartArt字体，求解决方案

一、Spire.Presentation的排查与修复 #

1. 修正文本属性访问层级 #

Spire中SmartArt节点的字体需要深入到TextFrame→Paragraph→TextRange层级修改，而非直接操作节点本身，示例代码：

from spire.presentation import *

presentation = Presentation()
presentation.LoadFromFile("input.pptx")

def process_smartart_node(node):
    # 遍历节点文本段落与文本片段
    for paragraph in node.TextFrame.Paragraphs:
        for portion in paragraph.TextRanges:
            portion.LatinFont = TextFont("Arial")       # 英文/数字字体
            portion.EastAsianFont = TextFont("微软雅黑") # 中文字体
            portion.FontHeight = 12
    # 递归处理嵌套子节点
    for child_node in node.ChildNodes:
        process_smartart_node(child_node)

for slide in presentation.Slides:
    for shape in slide.Shapes:
        if shape.ShapeType == ShapeType.SmartArt:
            smart_art = shape
            for node in smart_art.Nodes:
                process_smartart_node(node)

presentation.SaveToFile("output.pptx", FileFormat.Pptx2013)
presentation.Dispose()

2. 版本与兼容性检查 #

• 升级Spire.Presentation至最新版，旧版本存在SmartArt处理的已知bug
• 确认目标字体已在系统中安装，未安装字体会被PowerPoint自动替换为默认字体

二、python-pptx的XML底层操作方案 #

python-pptx原生对SmartArt支持有限，可直接操作PPT的XML结构修改字体：

from pptx import Presentation

prs = Presentation("input.pptx")
nsmap = prs.part.nsmap

for slide in prs.slides:
    for shape in slide.shapes:
        # 通过形状名称识别SmartArt（多数SmartArt名称以"SmartArt"开头）
        if shape.name.startswith("SmartArt"):
            smartart_xml = shape._element
            # 遍历所有文本运行节点
            for r in smartart_xml.findall('.//a:r', nsmap):
                # 修改英文/数字字体
                r_font = r.find('.//a:rFont', nsmap)
                if r_font:
                    r_font.set('typeface', 'Arial')
                # 修改中文字体
                ea_font = r.find('.//a:ea', nsmap)
                if ea_font:
                    ea_font.set('typeface', '微软雅黑')
                # 修改字号（1pt = 100单位）
                sz = r.find('.//a:sz', nsmap)
                if sz:
                    sz.set('val', '2400')

prs.save("output.pptx")

注意：该方法依赖PPT的XML结构，不同版本PPT可能需要调整XPath路径。

三、替代方案：PowerPoint VBA脚本调用 #

利用PowerPoint原生API处理SmartArt是最可靠的方案，可通过Python调用VBA执行：

1. VBA脚本（保存为ChangeSmartArtFonts.bas） #

Sub ChangeSmartArtFonts()
    Dim slide As slide
    Dim shape As shape
    Dim saNode As SmartArtNode
    
    For Each slide In ActivePresentation.Slides
        For Each shape In slide.Shapes
            If shape.Type = msoSmartArt Then
                For Each saNode In shape.SmartArt.AllNodes
                    With saNode.TextFrame2.TextRange.Font
                        .Name = "Arial"
                        .NameFarEast = "微软雅黑"
                        .Size = 12
                    End With
                    ProcessChildNodes saNode
                Next saNode
            End If
        Next shape
    Next slide
End Sub

Sub ProcessChildNodes(parentNode As SmartArtNode)
    Dim childNode As SmartArtNode
    For Each childNode In parentNode.ChildNodes
        With childNode.TextFrame2.TextRange.Font
            .Name = "Arial"
            .NameFarEast = "微软雅黑"
            .Size = 12
        End With
        ProcessChildNodes childNode
    Next childNode
End Sub

2. Python调用代码 #

import win32com.client
import os

ppt = win32com.client.Dispatch("PowerPoint.Application")
ppt.Visible = True
presentation = ppt.Presentations.Open(os.path.abspath("input.pptx"))
# 导入并执行VBA脚本（需提前将脚本导入PPT，或直接在代码中添加）
ppt.Run("ChangeSmartArtFonts")
presentation.SaveAs(os.path.abspath("output.pptx"))
presentation.Close()
ppt.Quit()

四、额外优化点 #

若SmartArt使用了主题字体，需同时修改幻灯片主题的字体设置：

# Spire.Presentation中修改主题字体示例
theme = presentation.Theme
theme.MajorFont.LatinFont = TextFont("Arial")
theme.MajorFont.EastAsianFont = TextFont("微软雅黑")
theme.MinorFont.LatinFont = TextFont("Arial")
theme.MinorFont.EastAsianFont = TextFont("微软雅黑")

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