python-docx读取Word表格为空列表，因不解析嵌套表格、文本框内表格及分节符后表格，且对标题行重复、合并单元格等结构敏感；需检查真实表格存在性、遍历header/footer、递归访问cell.tables。
用 python-docx 读取 Word 表格时为什么只拿到空列表？
因为 python-docx 默认不解析嵌套表格或文本框里的表格，且对“标题行重复”“合并单元格”“分节符后表格”等结构极其敏感。常见错误现象是：doc.tables 返回空列表，或只读到前几个表格。
实操建议：
- 先用
len(doc.tables)确认是否真为空，再检查 Word 文档是否实际含表格（比如有些“表格”其实是用制表符或空格模拟的） - 手动打开 Word → “文件 → 选项 → 显示 → 勾选‘显示所有格式标记’”，确认表格边框是否真实存在
- 若文档含分节符，需遍历每个
Section的header/footer—— 它们也可能藏表格，但doc.tables不包含这些 - 遇到嵌套表格（表格单元格里还有表格），必须递归访问：对每个
cell调用cell.tables
用 pandas.read_excel() 直接读取 Word 表格会报错 AttributeError: 'Table' object has no attribute 'rows'
这是典型混淆库的行为：pandas 本身不支持直接读 Word 表格，pandas.read_excel() 只处理 Excel 文件；有人误以为传入 table 对象就能自动转 DataFrame，其实不行。
正确做法是手动提取表格数据：
立即学习“Python免费学习笔记（深入）”；
- 遍历
table.rows，再遍历每行的cells，用cell.text.strip()取值（注意：合并单元格会导致某 cell.text 为空，需向前/向上查找最近非空值） - 用
pandas.DataFrame()构造，别用pd.read_*()系列函数 - 若表格有标题行，建议设
headers=0；若无标题，用headers=None避免首行被误当列名
示例片段：
rows = []
for row in table.rows:
cells = [cell.text.strip() for cell in row.cells]
rows.append(cells)
df = pd.DataFrame(rows)批量处理多个 .docx 文件时，中文列名导出到 Excel 出现乱码或格式错乱
根本原因不是编码问题，而是 openpyxl（pandas 默认 Excel 写入引擎）对中文列名、长文本、特殊字符（如换行符 ）默认处理粗暴：自动折行、列宽为 0、字体未设为支持中文的字体（如 "SimSun" 或 "Microsoft YaHei"）。
关键修复点：
- 导出时显式指定引擎：
df.to_excel(writer, index=False, engine="openpyxl") - 用
openpyxl手动调整列宽和字体（pandas 自带的ExcelWriter不支持直接设字体） - 提前清洗列名：用
df.columns = [c.replace(" ", " ").strip() for c in df.columns]去掉换行和空格 - 避免用
to_excel(..., header=True)后再写样式 —— 必须在写入后用workbook和worksheet对象操作
汇总多个表格到一个 Excel 的不同 sheet 时，sheet 名超限或重复怎么办？
Excel 工作表名最长 31 字符，且不能含 / ? * [ ] 等符号；批量处理时若直接用文件名或表格序号命名，极易触发 ValueError: Invalid worksheet name。
安全命名策略：
- 截断 + 后缀：用
os.path.basename(doc_path)[:25] + f"_t{i}"（i 是表格索引） - 用哈希替代长名：
hashlib.md5(doc_path.encode()).hexdigest()[:8] - 强制去非法字符：
re.sub(r'[\/*?[]]', '_', name) - 检测重名：用字典记录已用名，冲突时追加 "_1"、"_2"
注意：openpyxl 的 create_sheet() 不允许同名 sheet，但 pandas 的 ExcelWriter 在 mode="a" 下会静默覆盖 —— 务必用 mode="w" 并自己控制 sheet 名唯一性。
最易被忽略的是合并单元格的还原逻辑 —— python-docx 不提供“该单元格是否跨行/跨列”的直接属性，得靠比对 cell._tc.tcPr.tcW 或更稳妥的方式是解析 XML（table._tbl），但多数业务场景只需按视觉顺序填充空白即可。要不要深挖，取决于你的表格是否真有复杂合并结构。
