Mac终端Python3环境已安装xlrd仍报缺失依赖问题咨询

1. 校验Python环境匹配性 #

• 终端执行 which python3 和 which pip3，确认两个命令对应的Python版本路径完全一致。如果运行代码的是虚拟环境、系统自带Python或IDE自定义解释器，全局pip3安装的包不会被对应环境识别。
• 若使用虚拟环境运行代码，需先激活对应虚拟环境，再执行安装命令；若使用IDE（VS Code、PyCharm等）运行代码，需检查IDE设置中选中的解释器是否为 /usr/local/lib/python3.9 对应的Python3.9，也可以直接用解释器绝对路径执行安装：/usr/local/bin/python3.9 -m pip install xlrd

2. 处理xlrd版本适配问题 #

xlrd 2.0及以上版本已移除对*.xlsx格式文件的支持，仅支持.xls*格式文件：

• 若你是用pandas读取*.xlsx*文件，会因引擎不匹配触发提示缺xlrd的伪报错，两种解决方案二选一即可：
  • 降级xlrd到兼容版本：执行 pip3 install xlrd==1.2.0
  • 改用openpyxl作为*.xlsx*读取引擎：先执行 pip3 install openpyxl，读取Excel代码时指定引擎参数：pd.read_excel("你的文件.xlsx", engine="openpyxl")
• 若你是读取*.xls*格式的文件仍报错，可优先排查第一部分的环境匹配问题

3. 兜底排查操作 #

如果以上步骤都未解决，可强制重装xlrd排除包文件损坏问题：pip3 install --force-reinstall xlrd

内容的提问来源于stack exchange，提问作者Maher Mahmoud