python-docx 默认模板内置了多种表格样式（如 'table grid'、'light shading' 等），但官方未提供直接枚举样式的 api；可通过遍历 `document.styles` 并筛选 `wd_style_type.table` 类型样式，结合动态生成示例表格实现可视化预览。
在使用 python-docx 创建 Word 文档时，为表格应用美观统一的样式是提升文档专业性的关键一步。虽然文档中常直接写死样式名（如 table.style = 'Table Grid'），但开发者往往不清楚当前环境支持哪些表格样式——尤其当基于不同模板（如自定义 .dotx 文件）运行时，可用样式可能变化。
幸运的是，python-docx 的 Document 对象包含完整的样式库（doc.styles），我们可通过类型过滤提取全部表格样式，并逐一渲染示例表格以直观对比效果。以下是完整实现方案：
from docx import Document
from docx.enum.style import WD_STYLE_TYPE
from docx.shared import Pt
def list_table_styles_to_doc(output_path='available_table_styles.docx'):
doc = Document()
# 获取所有表格样式（按名称排序，提升可读性）
table_styles = [
style for style in doc.styles
if style.type == WD_STYLE_TYPE.TABLE
]
table_styles.sort(key=lambda s: s.name)
# 为每个样式添加标题和示例表格
for i, style in enumerate(table_styles, 1):
# 标题：样式序号 + 名称
doc.add_heading(f'{i}. "{style.name}"', level=2)
# 创建 2×3 示例表格
table = doc.add_table(rows=2, cols=3, style=style)
table.autofit = False
table.allow_autofit = False
# 设置固定列宽（避免自动缩放干扰视觉判断）
for cell in table.columns[0].cells:
cell.width = Pt(120)
for cell in table.columns[1].cells:
cell.width = Pt(80)
for cell in table.columns[2].cells:
cell.width = Pt(140)
# 填充表头与示例数据
hdr_cells = table.rows[0].cells
hdr_cells[0].text = 'Column A'
hdr_cells[1].text = 'Column B'
hdr_cells[2].text = 'Column C'
data_cells = table.rows[1].cells
data_cells[0].text = 'Data 1'
data_cells[1].text = 'Data 2'
data_cells[2].text = 'Data 3'
doc.save(output_path)
print(f"✅ 已生成包含 {len(table_styles)} 种表格样式的预览文档：{output_path}")
# 执行生成
list_table_styles_to_doc()⚠️ 注意事项：
- 此方法依赖于当前 Document() 实例所加载的默认模板（通常为 default.docx），若需测试自定义模板中的样式，请初始化时指定路径：Document('my_template.dotx')；
- 部分样式名含空格或特殊字符（如 'Medium Shading 1 Accent 1'），务必严格匹配大小写与空格；
- doc.styles 中的样式对象可能包含 built_in=True 属性，但 python-docx 不区分内置/用户样式，统一通过 type 过滤即可；
- 若输出文档中某样式显示为默认无格式表格，说明该样式在当前模板中未正确定义（可能是占位符），建议优先选用文档中明确列出的 标准样式（如 'Table Grid', 'Light Shading', 'Medium List 1' 等）。
运行上述脚本后，将生成一个 .docx 文件，其中每种表格样式均配有清晰编号与结构一致的示例表格，便于快速比对、选择与复用。这是在缺乏 GUI 样式面板的编程环境中，最可靠、可复现的样式探索方式。
立即学习“Python免费学习笔记（深入）”；
