tabulate库不直接支持DataFrame，因它仅解析二维可迭代对象，而DataFrame默认迭代返回列名而非行数据，故直接传入会报错或错位；需用df.values等转换并显式传headers。
Tabulate 库本身不直接支持 DataFrame 对象——它只接受列表、元组、字典或 NumPy 数组等基础结构。直接传入 pd.DataFrame 会报错或输出异常（比如把整个 DataFrame 当成单个单元格）。必须先转换数据结构。
为什么 tabulate(df) 会出错或显示混乱？
常见错误是直接调用 tabulate(df)，结果要么抛出 ValueError: Expected iterable，要么表格列错位、索引混入内容、中文对齐失效。这是因为 tabulate 不识别 DataFrame 的行列语义，它只按“二维可迭代对象”解析——而 df 默认迭代返回的是列名（不是行），list(df) 返回列名列表，df.values 才是真正的二维数组。
-
df.values是最常用转换方式，返回numpy.ndarray，兼容性好，但丢失列名和索引 - 要保留列名，必须显式传入
headers=df.columns.tolist() - 要保留索引列，需手动拼接：
[[idx] + list(row) for idx, row in df.iterrows()]，但性能差，小数据可用 - 推荐用
df.reset_index().values.tolist()+headers=df.reset_index().columns.tolist()，兼顾清晰与效率
如何控制对齐、边框和中文显示？
默认格式（plain）无边框，grid 和 fancy_grid 支持 Unicode 边框，但终端不支持时会显示乱码；中文列宽计算不准会导致换行或错位。关键参数是 tablefmt、colalign 和 maxcolwidths。
-
tablefmt="github"最稳妥：纯 ASCII，GitHub/CI/日志友好，且自动适配 Markdown 渲染 - 中文对齐建议统一用
colalign=("left",) * len(df.columns)，避免默认right导致数字右对齐但文字挤在一起 -
maxcolwidths=20可限制每列最大宽度，防止长文本撑开整表（注意这是列表，如[15, 20, None]可分列设置） - 禁用自动换行加
disable_numparse=True，否则含数字字符串（如 "2024-01"）可能被误转为浮点数
怎样在 Jupyter 中渲染带样式的 HTML 表格？
tabulate 本身不生成 HTML 样式，只输出字符串。想获得彩色、悬停、滚动等效果，不能依赖它。但在 Jupyter 中，可组合使用：
立即学习“Python免费学习笔记（深入）”；
- 用
tabulate(df.values, headers=df.columns, tablefmt="html")输出原始 HTML 表格字符串 - 再用
IPython.display.HTML()渲染，但该 HTML 无 CSS，样式简陋 - 真正美化应交给
df.style（Pandas 内置），例如df.style.set_properties(**{"text-align": "left"}).bar(subset=["score"]) - 若坚持用 tabulate 生成 HTML 再加工，需自行注入
<style>标签，且要注意 XSS 风险（尤其处理用户输入时）
真正麻烦的不是语法，而是混合类型列（比如一列里有 None、字符串、浮点数）触发的隐式类型转换——tabulate 会尝试统一格式，导致 None 变成 nan 或空字符串。预处理时用 df.fillna("") 或 df.astype(str) 更可控。
