1.1 安装与版本

本节大纲

  • pip install pandas==2.3.3
  • conda install pandas=2.3.3
  • import pandas as pd
  • pd.version
  • pd.show_versions()

1. pip install pandas==2.3.3

使用 Python 包管理器 pip 安装指定版本 2.3.3。

详细说明

  • 命令:pip install pandas==2.3.3
  • 适用场景:任何 Python 环境(虚拟环境、系统环境、容器等)。
  • 版本固定:== 表示精确匹配,确保安装的是 2.3.3 而非其他版本。
  • 依赖处理:pip 会自动安装 pandas 的必需依赖(如 NumPy、python-dateutil、pytz、tzdata)。可选依赖需手动添加,例如:
    pip install pandas==2.3.3[excel]   # 安装 Excel 相关依赖
    pip install pandas==2.3.3[sql]     # 安装 SQL 相关依赖
  • 升级:如果已安装旧版本,可用 --upgrade 强制升级。
  • 国内镜像:可使用 -i https://pypi.tuna.tsinghua.edu.cn/simple 加速。

验证安装

import pandas as pd
print(pd.__version__)  # 应输出 2.3.3

2. conda install pandas=2.3.3

使用 Conda 包管理器安装 pandas 2.3.3。

详细说明

  • 命令:conda install pandas=2.3.3
  • 适用场景:使用 Anaconda 或 Miniconda 的用户,尤其是科学计算环境。
  • 与 pip 的区别:
    • Conda 会管理所有依赖(包括非 Python 库),环境隔离更彻底。
    • Conda 安装的包来自 conda-forge 或默认源,可能与 PyPI 版本编译选项不同。
  • 版本写法:pandas=2.3.3 表示指定版本,也可用 >=2.3,<2.4 等范围。
  • 指定通道:conda install -c conda-forge pandas=2.3.3 推荐使用 conda-forge 获取最新版本。
  • 环境管理:建议在独立环境中安装:
    conda create -n myenv python=3.11 pandas=2.3.3
    conda activate myenv

3. import pandas as pd

导入 pandas 库并设置常用别名 pd。

详细说明

  • 标准约定:import pandas as pd 是全世界通用的别名,几乎所有文档和代码都使用 pd。
  • 用途:简化代码,例如 pd.DataFrame() 而不是 pandas.DataFrame()。
  • 可选导入方式:
    • import pandas —— 不推荐,因为后续调用太长。
    • from pandas import * —— 极其不推荐,会污染命名空间。
  • 同时导入其他常用库:
    import numpy as np
    import pandas as pd

4. pd.__version__

查看当前 pandas 版本号。

详细说明

  • 属性:pd.__version__ 返回一个字符串,如 '2.3.3'。
  • 用途:
    • 检查版本是否符合要求。
    • 在代码中做版本兼容判断:
      if pd.__version__ >= '2.0':
          # 使用新特性
  • 注意:这是一个属性,不是方法,不需要括号。

5. pd.show_versions()

显示 pandas 及其依赖库的版本详细信息。

详细说明

  • 函数:pd.show_versions() 无参数,打印环境信息。
  • 输出内容:
    • pandas 版本
    • Python 版本
    • 操作系统
    • 关键依赖版本:NumPy、python-dateutil、pytz、tzdata、pyarrow 等
    • 可选依赖版本(如果安装)
  • 用途:报告 Bug 或寻求帮助时提供完整环境信息。
  • 示例输出(节选):
    INSTALLED VERSIONS
    ------------------
    commit           : ...
    python           : 3.11.5
    python-bits      : 64
    OS               : Linux
    pandas           : 2.3.3
    numpy            : 1.26.4
    pytz             : 2024.1
    dateutil         : 2.9.0