如何在Poetry中将预编译OpenCV添加为项目依赖？

你报错的核心原因是：Poetry中path类型的依赖默认指向的是Python包目录、源码压缩包或wheel安装包，你直接指定单个.so动态链接库文件，Poetry会尝试将其作为压缩包解压读取，自然触发tarfile的ReadError。

方法1：配置Poetry虚拟环境继承全局site-packages（最快） #

如果你不介意虚拟环境能访问所有全局安装的Python库，直接修改虚拟环境配置即可：

1. 先激活项目的Poetry虚拟环境：执行poetry shell
2. 执行以下命令开启全局包继承：

python3 -m venv --system-site-packages $VIRTUAL_ENV

3. 验证：执行python -c "import cv2; print(cv2.__version__)"即可看到正常输出版本号。

方法2：手动链接全局OpenCV库到虚拟环境（仅导入需要的包，不继承全部全局包） #

如果不想让虚拟环境访问所有全局库，单独把OpenCV的文件软链接到虚拟环境的site-packages目录即可：

1. 先获取虚拟环境site-packages路径，在Poetry shell中执行：

echo $VIRTUAL_ENV/lib/python3.8/site-packages

2. 执行软链接命令，把全局OpenCV的目录链接过去：

ln -s /usr/local/lib/python3.8/site-packages/cv2 【上一步输出的路径】/cv2

3. 同样执行导入验证命令确认可用，不需要修改pyproject.toml的依赖配置。

方法3：正确配置path依赖指向完整包目录 #

如果你一定要在pyproject.toml中声明依赖，要指向整个cv2包目录而非单个so文件：

[tool.poetry.dependencies]
cv2 = { path = "/usr/local/lib/python3.8/site-packages/cv2", develop = true }

之后执行poetry install就不会再报解压错误。

• 以上所有方法都要求全局安装的OpenCV对应的Python版本，和Poetry虚拟环境使用的Python版本完全一致（你这里都是3.8，满足要求）
• 如果后续更换Python版本或者全局OpenCV路径，需要重新执行对应配置。

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