我来帮你搞定这个问题！你遇到的横向页面下表格列宽不生效的情况，核心原因是python-docx中表格的列宽是由table.columns对象统一控制的，单独设置单个单元格的width属性往往会被忽略，尤其是在新创建的section里。纵向页面下可能碰巧生效，但这不是正确的做法。

问题分析 #

你当前的代码是直接设置单元格的width：

hdr_cells[0].width = Cm(4)
hdr_cells[1].width = Cm(5)

这种方式在很多场景下（尤其是新section）不会生效，因为表格的列宽优先级更高的是列级别的设置，单元格宽度默认继承列的宽度，单独修改单元格不会改变整列的宽度。

解决方案 #

你需要直接设置表格对应列的宽度，而不是单个单元格的宽度。同时确保section的页面设置正确（其实设置orientation = WD_ORIENT.LANDSCAPE后，python-docx会自动调整页面宽高，手动设置也没问题，不用太纠结数值）。

修改后的完整代码如下：

from docx import Document
from docx.enum.section import WD_SECTION, WD_ORIENT
from docx.enum.table import WD_TABLE_ALIGNMENT
from docx.shared import Cm, Inches

document = Document()

# 添加分页和横向section
document.add_page_break()
new_section = document.add_section(WD_SECTION.ODD_PAGE)
new_section.orientation = WD_ORIENT.LANDSCAPE
# 手动设置宽高也可以，不设置的话python-docx会自动处理
new_section.page_width = Inches(11.7)
new_section.page_height = Inches(8.3)

document.add_heading('Multiple Setter', level=1)
table = document.add_table(rows=1, cols=5)
table.allow_autofit = False
table.alignment = WD_TABLE_ALIGNMENT.LEFT
table.style = "Table Grid"

# 关键：设置表格列的宽度，而不是单元格
table.columns[0].width = Cm(4)
table.columns[1].width = Cm(5)
# 如果其他列需要设置宽度，也可以在这里添加
# table.columns[2].width = Cm(3)
# table.columns[3].width = Cm(3)
# table.columns[4].width = Cm(3)

hdr_cells = table.rows[0].cells
hdr_cells[0].text = 'Variable'
hdr_cells[1].text = 'Function Writing'

额外说明 #

• 如果你的需求是同一列中不同行的单元格宽度不同，那确实需要设置单个单元格的width，但此时必须确保table.allow_autofit = False，并且要注意这种非统一列宽的设置在Word中可能有兼容性问题，建议尽量使用统一列宽。
• 另外，确认你导入了所有需要的模块（比如from docx.shared import Cm, Inches），避免因为缺失模块导致的隐性错误。

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