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 等通用性强的样式。
? 可视化对比：一键生成样式速查表
为直观评估效果，推荐生成一个「样式对照表」文档，每种样式单独一行表格，含样式名与示例内容：
第一步】：将安装包中所有的文件夹和文件用ftp工具以二进制方式上传至服务器空间;(如果您不知如何设置ftp工具的二进制方式，可以查看：(http://www.shopex.cn/support/qa/setup.help.717.html)【第二步】：在浏览器中输入 http://您的商店域名/install 进行安装界面进行安装即可。【第二步】：登录后台，工具箱里恢复数据管理后台是url/sho
立即学习“Python免费学习笔记（深入）”；
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.TABLE
]
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 表格真正实现所见即所得的专业排版。
