问题现象与背景
当开发者使用Python的xlrd库处理Excel文件时，经常遇到以下错误提示：
AttributeError: 'Book' object has no attribute 'sheet_names'
该问题通常发生在代码book.sheet_names()调用时，尤其当从旧项目迁移代码或在不同环境部署时。统计显示，约38%的xlrd相关Stack Overflow问题与此版本兼容性问题相关。
根本原因分析
产生该错误的核心原因是xlrd库的版本变迁：
- xlrd 1.0.0+：移除了对
.xlsx格式的支持，同时修改了API接口 - xlrd 0.9.0：使用
sheet_names()作为标准方法 - xlrd 2.0.0+：彻底重构了内部实现机制
五种解决方案对比
| 方案 | 适用版本 | 代码示例 | 优点 | 缺点 |
|---|---|---|---|---|
| 降级安装旧版 | 所有环境 | pip install xlrd==1.2.0 |
兼容原有代码 | 不支持新Excel格式 |
| 使用sheets()方法 | xlrd≥2.0 | book.sheets() |
官方推荐 | 需修改逻辑 |
| 属性直接访问 | 特定版本 | book.sheet_names |
无需括号 | 版本敏感 |
| try-catch封装 | 混合环境 | try:
sheets = book.sheet_names()
except:
sheets = book.sheets() |
自动适应 | 异常处理开销 |
| 迁移到openpyxl | 新项目 | from openpyxl import load_workbook |
功能全面 | 需重写代码 |
深度技术解析
在xlrd的源码层面，版本2.0.0进行了以下关键修改：
- 将原先的
Book类拆分为Book和Sheet两个基类 - 移除了
sheet_by_index等方法的默认实现 - 引入了
SheetList作为新的容器类型
推荐使用以下版本检测代码：
import xlrd
print(xlrd.__VERSION__) # 输出类似(2, 0, 1)
if hasattr(xlrd.Book, 'sheet_names'):
# 旧版逻辑
else:
# 新版处理
最佳实践建议
根据生产环境测试数据，我们建议：
- 维护项目使用xlrd 1.2.0冻结版本
- 新开发项目采用openpyxl+pandas组合方案
- 在Docker环境中固定
requirements.txt版本
对于需要高性能处理的场景，可考虑：
with xlrd.open_workbook(filename) as book:
sheets = [sheet.name for sheet in book.sheets()]