如何使用docx库设置Word文档中段落的字体、大小和加粗格式？

Question

在使用`python-docx`库设置Word文档段落格式时，如何同时指定字体、大小和加粗样式？ 常见问题：虽然可以通过`paragraph.style`或`run.font`设置字体属性，但有时发现字体名称无效或加粗效果未正常显示。例如，代码中设置了`run.font.name = "微软雅黑"`，但生成的文档字体并未改变。此外，尝试通过`run.bold = True`启用加粗，却未生效。 解决方法：确保为每个字符单独应用样式（通过`run`对象），而非直接修改段落样式。同时，在设置中文字体时，需额外指定`run._element.rPr.rFonts.set(qn('w:eastAsia'), '微软雅黑')`，以兼容中英文字体差异。最后，确认`run.font.size`使用`Pt()`函数定义字号单位。

Answer 1

1. 问题概述

在使用 `python-docx` 库时，设置 Word 文档段落格式是一个常见的需求。然而，用户可能会遇到字体名称无效或加粗效果未正常显示的问题。例如，设置了 `run.font.name = "微软雅黑"` 后，生成的文档字体并未改变；或者通过 `run.bold = True` 启用加粗，却未生效。

这些问题通常源于对 `python-docx` 的底层实现不够了解，尤其是中英文字体差异和样式应用方式的理解不足。

常见问题列表

• 为什么设置字体后，生成的文档字体没有变化？
• 如何正确地为中文字符指定字体？
• 为什么加粗样式无法生效？

2. 分析与解决方法

要同时指定字体、大小和加粗样式，需要确保以下几点：

2.1 确保样式应用于每个字符（Run）

`python-docx` 的 `paragraph.style` 只能影响整个段落的基本样式，而具体到每个字符的样式（如字体、加粗等），需要通过 `run` 对象来单独设置。

代码示例：

from docx import Document
from docx.shared import Pt

doc = Document()
paragraph = doc.add_paragraph()

run = paragraph.add_run("这是一个测试文本")
run.font.size = Pt(12)  # 设置字号为12磅
run.bold = True          # 设置加粗
    

2.2 中文字体兼容性问题

对于中文字体，`run.font.name` 并不足以覆盖所有场景，因为 Word 内部区分了西文和中文的字体设置。必须通过修改底层 XML 元素来指定中文字体。

代码示例：

from docx.oxml.ns import qn

run._element.rPr.rFonts.set(qn('w:eastAsia'), '微软雅黑')  # 指定中文字体
run.font.name = "Times New Roman"  # 指定西文字体
    

2.3 字号单位的正确设置

`run.font.size` 必须使用 `Pt()` 函数定义字号单位，否则可能导致格式异常。

代码示例：

run.font.size = Pt(14)  # 正确设置字号为14磅
    

3. 流程图说明

以下是解决问题的整体流程图，帮助理解各个步骤之间的关系：

graph TD;
            A[问题描述] --> B{是否需要设置字体？};
            B --是--> C[使用 run.font.name];
            B --否--> D[跳过字体设置];
            C --> E{是否包含中文？};
            E --是--> F[设置 w:eastAsia 属性];
            E --否--> G[继续设置其他属性];
            G --> H[设置字号和加粗];
            H --> I[完成];

4. 总结与扩展

通过以上分析和解决方案，可以有效解决 `python-docx` 在设置字体、大小和加粗样式时遇到的问题。需要注意的是：

1. 样式应通过 `run` 对象逐一应用。
2. 中文字体需额外指定 `w:eastAsia` 属性。
3. 字号单位必须使用 `Pt()` 函数。

此外，如果需要更复杂的样式控制，可以深入研究 `python-docx` 的底层 XML 结构，甚至直接操作 XML 元素。