如何用python-docx设置页眉表格内容为RTL（从右到左）方向

python-docx的高层API对RTL（从右到左）文本方向的支持有限，尤其是页眉中的表格单元格，需要直接操作底层OOXML元素来实现。以下是可行的解决方案：

完整实现代码 #

from docx import Document
from docx.oxml.ns import qn

document = Document("test.docx")

# 定位页眉中的目标单元格
cell = document.sections[0].header.tables[0].rows[0].cells[0]

# 设置波斯语文本
cell.text = "سلام"

# 1. 配置段落的RTL方向（核心：开启段落双向文本属性）
paragraph = cell.paragraphs[0]
p_pr = paragraph._p.get_or_add_pPr()
bidi_element = p_pr.get_or_add_bidi()
bidi_element.val = qn("w:on")

# 2. 配置单元格的文本布局方向为RTL
tc_pr = cell._tc.get_or_add_tcPr()
text_dir_element = tc_pr.get_or_add_textDirection()
text_dir_element.val = "rtlb"  # 对应Word中"从右到左，从上到下"的文本方向

document.save("output.docx")

关键说明 #

• 段落bidi属性：这是让波斯语文本按RTL顺序排列的核心设置，OOXML中通过w:bidi标签控制，设置为on即可启用RTL段落方向。
• 单元格文本方向：设置w:textDirection为rtlb，确保单元格内部的文本布局符合RTL语言的阅读习惯。
• 之前尝试的方法无效原因：
  • WD_TABLE_DIRECTION.RTL仅控制表格列的排列顺序（从右到左显示列），不影响单元格内文本方向；
  • run.font.rtl在python-docx中无实际作用，RTL方向是段落级属性而非字符级；
  • Unicode控制字符（如\u202B）在Word的格式化单元格中容易被忽略，无法稳定生效。

内容的提问来源于stack exchange，提问作者Amirreza A.