17370845950

python-docx 默认模板内置了多种预定义表格样式（如 'table grid'、'light shading' 等），但官方未提供直接枚举样式的 api；可通过遍历 `document.styles` 并筛选 `type == wd_style_type.table` 获取全部名称，并生成可视化示例文档进行比对。

在使用 python-docx 创建 Word 文档时，为表格应用美观统一的样式是提升专业性的关键一步。虽然文档中常直接写死 'Table Grid' 这类样式名，但你可能并不清楚——当前文档默认模板究竟支持哪些表格样式？它们实际渲染效果如何？ 遗憾的是，python-docx 并未提供类似 Document.available_table_styles() 的便捷方法，但我们可以借助其样式系统手动提取并可视化全部可用表格样式。

✅ 正确获取所有表格样式名称

python-docx 的样式体系基于底层 Word 默认模板（Normal.dotm），所有内置表格样式均以 WD_STYLE_TYPE.TABLE 类型注册在 document.styles 中。以下代码可安全列出当前环境全部可用的表格样式名（按名称排序，排除自定义或无效样式）：

from docx import Document
from docx.enum.style import WD_STYLE_TYPE

doc = Document()
table_styles = [
    style.name for style in doc.styles 
    if style.type == WD_STYLE_TYPE.TABLE
]
table_styles.sort()  # 推荐排序便于查阅
print("Available table styles:")
for i, name in enumerate(table_styles, 1):
    print(f"{i:2d}. {name}")

常见输出包括（具体取决于 Office 版本和模板）：

 1. Light Shading
 2. Light Shading Accent 1
 3. Light List
 4. Light List Accent 1
 5. Table Grid
 6. Table Grid Accent 1
 7. Table Style Medium Shading 1 Accent 1
 ...

⚠️ 注意：样式名区分大小写，且必须完全匹配（如 'table grid' 会报错）；部分样式在旧版 Word 中可能不显示或渲染异常，建议优先选用 Light Shading、Table Grid、Medium List 等通用性强的样式。

? 可视化对比：一键生成样式速查表

为直观评估效果，推荐生成一个「样式对照表」文档，每种样式单独一行表格，含样式名与示例内容：

from docx import Document
from docx.enum.style import WD_STYLE_TYPE
from docx.shared import Pt

doc = Document()

# 标题
doc.add_heading('Python-docx 表格样式速查表', level=1)
doc.add_paragraph('注：样式渲染效果依赖 Word 应用端，默认模板下展示最准确。')

# 获取并排序样式
table_styles = [
    s.name for s in doc.styles 
    if s.type == WD_STYLE_TYPE.TAB
LE
]
table_styles.sort()

# 为每个样式生成一行示例表
for style_name in table_styles:
    p = doc.add_paragraph()
    p.add_run(f"▶ 样式名: '{style_name}'").bold = True

    table = doc.add_table(rows=2, cols=3, style=style_name)
    table.autofit = False
    table.allow_autofit = False

    # 设置列宽（单位：EMU，1 Pt ≈ 12700 EMU）
    for cell in table.rows[0].cells:
        cell.width = int(100 * 12700)  # ≈ 100 Pt

    # 填充示例内容
    headers = ['列 A', '列 B', '列 C']
    data = ['示例', '数据', '行 1']

    for i, text in enumerate(headers):
        table.cell(0, i).text = text
        table.cell(0, i).paragraphs[0].runs[0].font.size = Pt(10)

    for i, text in enumerate(data):
        table.cell(1, i).text = text
        table.cell(1, i).paragraphs[0].runs[0].font.size = Pt(9)

doc.save('table_styles_reference.docx')
print(f"✅ 已生成样式对照文档：table_styles_reference.docx（共 {len(table_styles)} 种样式）")

运行后将得到一个清晰的 .docx 文件，每种样式独立呈现，方便你在 Word 中直接预览真实效果、选择最适合项目需求的风格。

? 小结与最佳实践

• 不要硬编码未知样式名：始终先通过 doc.styles 动态获取，避免因环境差异导致 KeyError；
• 样式兼容性优先：生产环境推荐使用 Light Shading（简洁现代）、Table Grid（经典网格）、Medium List（带分隔线）等跨版本稳定样式；
• 自定义样式需谨慎：若需专属样式，应通过 Word UI 定义后保存为新模板（.dotx），再用 Document('template.dotx') 加载；
• 性能提示：样式枚举本身开销极小，但生成数百个表格会影响文档体积和加载速度，仅在调试/选型阶段使用可视化方案。

掌握这套方法，你就能彻底告别“猜样式名”的低效开发，让 python-docx 表格真正实现所见即所得的专业排版。