website

Pandas Docs

所属分类:开发者在线工具箱

开源数据分析库 pandas 的官方文档,含安装、教程与 API 参考。

Pandas Docs 是 pandas 数据分析库的官方文档站,设有入门、用户指南、API 参考和开发指南四个入口。入门页给出 conda 与 pip 两种安装命令,并用问题列出读写表格、选取数据、画图等常见任务的教程。

Pandas Docs:pandas 数据分析库的官方文档,从安装入门到查询 API

发布于 2026年10月18日更新于 2026年10月29日

首页的四个入口与版本

首页开头写明,pandas 是一个开源、以 BSD 许可证发布的 Python 库,提供高性能、易于使用的数据结构和数据分析工具。页面中部用四张卡片分出入门(Getting started)、用户指南(User guide)、API 参考(API reference)和开发指南(Development)。

首页还标出版本和日期:截至 2026 年 10 月底,首页显示的版本是 3.1.0,发布日期为 2026 年 10 月 22 日。版本菜单列出开发版(dev)、3.1 稳定版,以及 3.0 到 1.0 的历史版本;首页也提供整份文档的 Zipped HTML 下载。

pandas 官方文档首页截图,顶部为导航栏,正文标题为 pandas documentation,下方显示版本信息和两张入口卡片

上面的截图是较早的首页,标注的版本是 3.0.6,日期为 2026 年 9 月 17 日。阅读时应以页面顶部版本菜单显示的版本为准,不要把截图中的版本号当作当前版本。

从入门页开始

入门页先给出两种安装方式。使用 conda 时,从 conda-forge 安装,命令是 conda install -c conda-forge pandas;使用 pip 时,从 PyPI 安装,命令是 pip install pandas。如果需要指定版本或从源码安装,页面会引导到单独的高级安装页。

页面还提供“Try pandas online”入口,说明可以在浏览器中直接试用 pandas,无需先在本机安装。

“Intro to pandas”部分以问题组织内容,每个问题都链接到一篇教程。页面列出的问题包括:pandas 能处理什么样的数据、如何读写表格数据、如何选取表格的子集、如何画图、如何由已有列生成新列、如何计算汇总统计、如何重塑表格布局、如何合并多个表格、如何处理时间序列,以及如何处理文本数据。

pandas 入门指南页截图,左侧是目录,正文顶部是 conda 与 pip 两张安装卡片

从其他工具转来的读者

入门页的“Coming from…”部分把 pandas 与读者可能熟悉的软件做了对照,包括 R 的 data.frame 与 tidyverse、SQL 的 SELECT、GROUP BY 和 JOIN、Stata 的数据集、Excel 等电子表格,以及 SAS。每一项都附有“Learn more”链接,指向该软件中相应操作在 pandas 里的写法。

对于想快速了解全貌的读者,入门页推荐“10 Minutes to pandas”作为概览,并提到可以配合 pandas 速查表(cheat sheet)使用。

用户指南与 API 参考的分工

首页对两个部分的说明很清楚。用户指南讲解 pandas 的关键概念,并提供背景知识;API 参考描述每个方法如何工作、接受哪些参数,并假定读者已经理解这些关键概念。因此初次使用时可以先读用户指南建立概念,需要查某个方法的参数时再进入 API 参考。

版本、开发与反馈渠道

首页的 Useful links 列出了 PyPI 上的二进制安装包、源代码仓库、问题与想法的反馈页面、Stack Overflow 上的 pandas 标签问答,以及邮件列表。

开发指南面向想要参与改进的读者,说明如何修正文档中的错字、改进现有功能,并链接到贡献指南。