我们应该使用 pandas.compat.StringIO 还是 Python 2/3 StringIO？

Question

StringIO 是我们在从文本中读取Pandas数据帧时使用的类似文件的字符串缓冲区对象，例如“如何从字符串创建 Pandas数据帧？”

我们应该将这两个导入中的哪一个用于 StringIO（在熊猫中）？这是一个长期存在的问题，四年来从未得到解决。

1. StringIO.StringIO（Python 2）/ io.StringIO（Python 3）
   • 优点：对于面向未来的代码更稳定，但迫使我们进行版本分叉，例如参见 EmilH 底部的代码。
2. pandas.compat.StringIO
   • pandas.compat 是在 0.13.0（2014 年 1 月）中引入的 2/3 兼容性包（“无需 2to3”）
   • 从 0.22 开始，pandas.compat 包仍被标记为“私有”，并且没有计划使“公共”说“警告 pandas.core、pandas.compat 和 pandas.util 顶级模块被认为是私有的。功能的稳定性在那些模块中不能保证。” 虽然它们基本上从 0.13 开始就没有坏过
   • pandas.compat 源定义了导入builtins, StringIO/cStringIO, BytesIO, cPickle, httplib、范围、过滤器、映射和 zip 的迭代器版本，以及 Python 3 兼容性的其他必要元素 - 请参阅0.13.0 最新消息

用于从标准（来自 EmilH）导入的版本 2/3 分叉代码：

import sys
if sys.version_info[0] < 3: 
    from StringIO import StringIO
else:
    from io import StringIO

# Note: but this is very much a poor-man's version of pandas.compat, which contains much much more

笔记：

• pandas.compat 自 pandas 0.13.0（2014 年 1 月）以来作为 pandas 中的一个子包存在
• 它似乎也作为独立包发布：0.1.0（2017 年 6 月 10 日）和 0.1.1（2017 年 6 月 10 日）

Answer 1

我知道这是一个老问题，但我在这里跟踪了面包屑，所以也许仍然值得回答。它并不完全确定，但当前的 Pandas 文档建议使用内置方法StringIO而不是它自己的内部方法。

对于使用该类的示例StringIO，请确保使用from io import StringIOPython 3 导入它。

Answer 2

仅供参考，从 pandas 0.25 开始，StringIO已从pandas.compat( PR #25954 ) 中删除，因此您现在将看到：

from pandas.compat import StringIO

ImportError：无法从“pandas.compat”导入名称“StringIO”

这意味着唯一的答案是从io模块导入。