使用python-docx设置表格列宽无效，求问题排查与解决建议

我尝试用python-docx设置表格列宽，但始终没成功。查资料看到类似table.cell(0,0).width = 1097280的代码应该能设置单元格宽度，也知道Mm(10)可以把10毫米转成EMU单位，但实际操作后，我创建的1行3列表格始终是三列宽度均等，试了多种方法都没用。

我的代码 #

from docx import Document
from docx.shared import Pt, Mm, Cm, Inches
from docx.enum.table import WD_ALIGN_VERTICAL, WD_TABLE_ALIGNMENT


filename = "/home/pedro/myPython/docxFiles/example_table.docx"
doc = Document()
# 原代码存在引号语法错误，已修正
heading = 'Shiny new but awkward table\n\n'
doc.add_heading(heading, 4)
table = doc.add_table(rows=1, cols=3)
table.alignment = WD_TABLE_ALIGNMENT.CENTER
table.autofit = False
table.allow_autofit = False
table.style = 'Table Grid'
headers = ["Name", "Age", "Occupation"]
widths = [15.9, 11.8, 26.7]
for col, col_data in enumerate(headers):
    print(col, col_data)
    table.cell(0,col).text = col_data
   
for col, width in enumerate(widths):
   print(col, width)
   table.cell(0, col).width = Mm(widths[col])
doc.save(filename)

疑问 #

1. 我哪里操作出错了？
2. 会不会是用LibreOffice而非MS Word打开文档导致的显示问题？
3. 最终希望能根据列中最长字符串自动设置列宽，或者设置固定最大值，但现在连固定宽度都设不了，求解决建议。

问题原因分析 #

1. 单元格宽度设置逻辑错误：python-docx中，Word表格的列宽由table.columns对象控制，而非单个单元格。直接设置单元格宽度会被列的默认规则覆盖，无法生效。
2. 表格样式干扰：Table Grid样式自带默认列宽规则，可能会覆盖自定义的宽度设置。
3. LibreOffice兼容性问题：LibreOffice对Word格式的解析逻辑与MS Word存在差异，部分Word专属格式设置在LibreOffice中可能无法正确渲染。

解决方案 #

1. 正确设置固定列宽

修改代码，直接针对表格列设置宽度，而非单个单元格：

from docx import Document
from docx.shared import Mm
from docx.enum.table import WD_TABLE_ALIGNMENT

filename = "/home/pedro/myPython/docxFiles/example_table.docx"
doc = Document()
heading = 'Shiny new but awkward table'
doc.add_heading(heading, 4)
table = doc.add_table(rows=1, cols=3)
table.alignment = WD_TABLE_ALIGNMENT.CENTER
table.autofit = False
table.allow_autofit = False
table.style = 'Table Grid'

headers = ["Name", "Age", "Occupation"]
widths = [15.9, 11.8, 26.7]

# 填充表头内容
for col, col_data in enumerate(headers):
    table.cell(0, col).text = col_data

# 关键：针对每一列设置宽度
for idx, width in enumerate(widths):
    table.columns[idx].width = Mm(width)

doc.save(filename)

2. 根据内容自动调整列宽

python-docx本身没有直接提供内容自适应列宽的API，可通过两种方式实现：

• 手动估算宽度：计算每列最长文本的字符数，按平均字符宽度（如每个字符6Pt）估算列宽后设置。
• 调用Word COM接口实现自动化：借助win32com.client调用Word的自动调整功能：

import win32com.client as win32

word = win32.gencache.EnsureDispatch('Word.Application')
doc = word.Documents.Open(r"/home/pedro/myPython/docxFiles/example_table.docx")
table = doc.Tables(1)
# 1对应wdAutoFitContent，即根据内容自动调整列宽
table.AutoFitBehavior(1)
doc.Save()
doc.Close()
word.Quit()

3. 验证注意事项

• 优先用MS Word打开文档验证格式，排除LibreOffice的兼容性干扰。
• 确保table.autofit和table.allow_autofit均设为False，避免自动调整覆盖自定义宽度。

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