Python-docx表格列宽设置失效：窄列无法突破1英寸默认值

问题根源 #

'Colorful List'表格样式默认带有最小列宽1英寸的约束，只要手动设置的列宽小于这个值，就会被样式规则覆盖，导致窄列自动变回1英寸。

两种可行解决方法 #

方法1：修改样式的最小列宽约束 #

直接通过XML操作修改该样式的布局规则，取消最小列宽限制，后续设置的列宽就能正常生效：

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

# 创建文档
doc = Document()
doc.add_heading('Projektübersicht', 0)

# 添加表格并应用Colorful List样式
table = doc.add_table(rows=1, cols=6)
table.style = 'Colorful List'

# 核心操作：修改样式的布局设置，移除自动调整和最小列宽约束
style_element = doc.styles['Colorful List']._element
tbl_style_pr = style_element.xpath('./w:tblStylePr')[0]
# 删除原有布局设置
for child in tbl_style_pr.getchildren():
    if child.tag == qn('w:tblLayout'):
        tbl_style_pr.remove(child)
# 添加固定布局设置，禁用自动调整
new_layout = tbl_style_pr.add_new_child(qn('w:tblLayout'))
new_layout.set(qn('w:type'), 'fixed')

# 关闭表格自动调整
table.autofit = False
table.allow_autofit = False

# 设置各列宽度
table.columns[0].width = Cm(1.5)
table.columns[1].width = Cm(3)
table.columns[2].width = Cm(7)
table.columns[3].width = Cm(1.8)
table.columns[4].width = Cm(1.8)
table.columns[5].width = Cm(1.5)

# 设置表头
header = table.rows[0].cells
header[0].text = 'Nr.'
header[1].text = 'Teilprojekt'
header[2].text = 'Kurzbeschreibung'
header[3].text = 'M'
header[4].text = 'M Name'
header[5].text = 'Status'

# 添加数据行（假设projects是你的数据集）
for project in projects:
    row = table.add_row().cells
    row[0].text = str(project.number)
    row[1].text = str(project.name)
    row[2].text = str(project.kurzbeschreibung)
    row[3].text = str(project.m1)
    row[4].text = str(project.m1name)

# 保存文档
doc.save('projekt_uebersicht.docx')

方法2：逐个设置单元格宽度（更直接的强制覆盖） #

如果修改样式的方式不生效，直接给每一行的每个单元格单独设置宽度，彻底绕过样式的约束：

from docx import Document
from docx.shared import Cm

doc = Document()
doc.add_heading('Projektübersicht', 0)

table = doc.add_table(rows=1, cols=6)
table.style = 'Colorful List'

# 关闭自动调整
table.autofit = False
table.allow_autofit = False

# 定义各列目标宽度
col_widths = [Cm(1.5), Cm(3), Cm(7), Cm(1.8), Cm(1.8), Cm(1.5)]

# 设置表头单元格宽度和内容
header = table.rows[0].cells
for idx, cell in enumerate(header):
    cell.width = col_widths[idx]
header[0].text = 'Nr.'
header[1].text = 'Teilprojekt'
header[2].text = 'Kurzbeschreibung'
header[3].text = 'M'
header[4].text = 'M Name'
header[5].text = 'Status'

# 添加数据行并设置每个单元格宽度
for project in projects:
    row = table.add_row().cells
    # 先设置宽度再填内容
    for idx, cell in enumerate(row):
        cell.width = col_widths[idx]
    row[0].text = str(project.number)
    row[1].text = str(project.name)
    row[2].text = str(project.kurzbeschreibung)
    row[3].text = str(project.m1)
    row[4].text = str(project.m1name)

doc.save('projekt_uebersicht.docx')

关键注意点 #

• 两种方法都必须确保table.autofit = False和table.allow_autofit = False，防止Word自动调整列宽。
• 方法1只需修改一次样式，所有使用该样式的表格都会受益；方法2适合单个表格的特殊需求，兼容性更强。

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