Pipenv环境下使用camelot提示未检测到Ghostscript报错如何解决

该报错并非Python依赖缺失导致，核心原因是camelot-py运行时无法调用到系统层面的Ghostscript可执行程序：你之前安装的python-ghostscript只是Python语言层面的绑定包，不包含Ghostscript核心运行二进制；就算安装了系统版Ghostscript，若路径未被Pipenv虚拟环境识别、或Python绑定版本与系统Ghostscript版本不匹配，都会触发该报错。

1. 配置系统级Ghostscript并验证环境变量 #

• Windows：
  • 下载对应系统位数（32/64位）的Ghostscript安装包完成安装，默认安装路径为C:\Program Files\gs\gs<版本号>\bin
  • 将上述bin目录添加到系统PATH环境变量
  • 新开命令提示符窗口执行gswin64c -v（32位系统执行gswin32c -v），能正常输出版本号即为配置成功
• macOS：
  • 执行brew install ghostscript完成安装
  • 终端执行gs -v，能正常输出版本号即为配置成功
• Debian/Ubuntu系Linux：
  • 执行sudo apt install ghostscript完成安装
  • 终端执行gs -v，能正常输出版本号即为配置成功

2. 确认Pipenv虚拟环境可识别Ghostscript #

• 执行pipenv shell激活对应虚拟环境
• 在激活的环境中执行路径查询命令验证：
  • Windows：where gswin64c
  • macOS/Linux：which gs
• 若命令返回可执行文件完整路径即为识别成功；若提示找不到，重启终端重新加载环境变量即可，也可以将Ghostscript的bin目录绝对路径写入Pipenv的环境变量配置文件。

3. 修复Python依赖版本匹配问题 #

python-ghostscript版本必须和系统安装的Ghostscript大版本对应，否则也会触发识别失败：

• 先卸载混乱的历史依赖：
  pipenv uninstall camelot-py ghostscript python-ghostscript
• 重新安装带完整基础依赖的camelot-py：
  pipenv install "camelot-py[base]"
• 匹配系统Ghostscript版本安装绑定包：系统装Ghostscript 10.x版本执行pipenv install ghostscript==0.7，系统装Ghostscript 9.x版本执行pipenv install ghostscript==0.6

4. 兜底方案（以上步骤无效时使用） #

在代码中手动指定Ghostscript库路径，跳过自动查找逻辑，示例代码如下：

import ctypes
from ctypes.util import find_library

# 替换为你本机实际的Ghostscript库路径
# Windows示例路径：r"C:\Program Files\gs\gs10.02.0\bin\gswin64c.dll"
# macOS/Linux示例路径："/usr/local/lib/libgs.dylib" 或 "/usr/lib/x86_64-linux-gnu/libgs.so.9"
gs_lib_path = r"替换为你的实际路径"

if not find_library("gs"):
    ctypes.CDLL(gs_lib_path)

import camelot
tables = camelot.read_pdf('foo.pdf')

注意：Windows系统下需要加载bin目录下对应位数的dll文件，不要填成exe可执行文件路径。

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