Pandas报错：无法从pandas.io.formats.format导入TableFormatter

安全阿岳

2026-8-26

问题现象

可正常执行pd.read_csv()读取CSV文件，但执行df或df.head(5)查看DataFrame数据时触发ImportError，具体报错信息：

/Applications/Anaconda/anaconda3/lib/python3.9/site-packages/pandas/io/formats/html.py in <module>
     13 
     14 from pandas.io.common import is_url
---> 15 from pandas.io.formats.format import (
     16     DataFrameFormatter,
     17     TableFormatter,

ImportError: cannot import name 'TableFormatter' from 'pandas.io.formats.format' (/Applications/Anaconda/anaconda3/lib/python3.9/site-packages/pandas/io/formats/format.py)

解决方法

检查Pandas版本：该错误源于版本不兼容，TableFormatter在部分新版本Pandas中已被移除或重命名。执行pip show pandas查看当前版本。
升级或降级Pandas：
- 升级至最新稳定版：pip install --upgrade pandas
- 若升级后问题仍存在，可降级到已知兼容的版本（如1.5.x系列）：pip install pandas==1.5.3
修复损坏的安装：若Pandas安装文件损坏，先卸载后重装：
```
pip uninstall pandas -y
pip install pandas
```
确认虚拟环境：如果使用虚拟环境，确保当前激活的环境正确，避免不同环境的Pandas版本冲突。