Repolode
posit-dev

posit-dev/great-tables

一个 Python 库,用于将 pandas 或 Polars DataFrame 制作成样式精美的展示表格,可渲染为 HTML 或图片。

Star
2,903
Fork
141
未关闭 Issue
73
最近提交
前天

这是什么?

Great Tables 是一个用于把 DataFrame 转换为可直接展示的表格的 Python 库。它基于一组可组合的表格组件,包括表头和表尾、存放行标签的 stub、位于列标签上方的 spanner 标签等,用户可按需组合搭配。

单元格数值支持多种格式化方式,如货币、日期和紧凑数字格式,列也可以隐藏或调整顺序。输入数据可以是 pandas 或 Polars 的 DataFrame。通过链式调用 GT 对象的方法构建表格,结果默认渲染为 HTML,也可以保存为图片文件。

它主要用于 Jupyter Notebook 和 Quarto 文档中。在控制台中调用 show() 方法会在浏览器中打开表格。项目内置 16 个示例数据集,并提供在线文档和各方法的参考说明。

核心功能

  • 01基于 pandas 或 Polars DataFrame,通过链式方法构建表格。
  • 02支持表头、表尾、行标签 stub 以及列标签上方的 spanner 标签。
  • 03可对单元格进行货币、日期和紧凑数字等格式化。
  • 04默认渲染为 HTML,也可输出为图片文件。
  • 05内置 16 个示例数据集便于练习。

适用场景

  • 在 Jupyter Notebook 中展示汇总统计结果。
  • 在 Quarto 报告中生成格式规范的表格。
  • 为非技术读者美化 pandas 或 Polars 的查询结果。

快速上手

  1. 1

    从 PyPI 安装

    pip install great_tables
  2. 2

    在 Python 中导入 GT 和示例数据集

    from great_tables import GT from great_tables.data import sp500
  3. 3

    从 DataFrame 构建表格,并在 notebook 或 Quarto 文档中渲染

使用前须知

  • 默认渲染为 HTML,表格不会直接打印到控制台,查看输出需要使用 notebook、Quarto 或 show() 方法。

标签

常见问题

great-tables 是什么?
一个 Python 库,用于将 pandas 或 Polars DataFrame 制作成样式精美的展示表格,可渲染为 HTML 或图片。 Great Tables 是一个用于把 DataFrame 转换为可直接展示的表格的 Python 库。它基于一组可组合的表格组件,包括表头和表尾、存放行标签的 stub、位于列标签上方的 spanner 标签等,用户可按需组合搭配。
great-tables 可以免费使用吗?用的什么许可证?
great-tables 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
great-tables 还在维护吗?
活跃维护中。great-tables 最近一次提交是在 2026年10月18日。
great-tables 适合用来做什么?
在 Jupyter Notebook 中展示汇总统计结果。 在 Quarto 报告中生成格式规范的表格。 为非技术读者美化 pandas 或 Polars 的查询结果。
great-tables 怎么安装和运行?
从 PyPI 安装: pip install great_tables 在 Python 中导入 GT 和示例数据集: from great_tables import GT from great_tables.data import sp500 从 DataFrame 构建表格,并在 notebook 或 Quarto 文档中渲染
在哪里获取 great-tables?
源代码和安装说明在 GitHub 上:https://github.com/posit-dev/great-tables

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目