Python 3.12与pip 24.0环境下Python包安装路径错误求助

问题根源 #

你遇到的错误是因为包的配置文件中硬编码了Linux系统的绝对路径（/home/esabellico/workspace/confluent-kafka-python-sdist/LICENSE.txt），而你在Windows环境下安装时，setuptools的convert_path函数会严格校验路径，不允许使用绝对路径，直接抛出报错终止安装。同时原setup.py因为.egg文件被废弃无法使用，和当前路径问题叠加导致安装失败。

修复方案 #

1. 修改包的路径配置（推荐） #

如果是从源码包安装，解压后找到包根目录下的配置文件（通常是setup.py、pyproject.toml或setup.cfg）：

• 定位到引用绝对路径的代码行，比如setup.py中可能有类似license_files = ['/home/.../LICENSE.txt']的写法
• 将绝对路径替换为相对路径，如果LICENSE.txt在包根目录，直接改为LICENSE.txt即可
• 修改完成后，在源码目录执行pip install .完成安装

2. 降级工具版本兼容 #

pip 24.0和setuptools 69.2.0对路径的校验规则更严格，你可以尝试降级到较旧的兼容版本：

# 先降级pip和setuptools
pip install pip==23.3.1 setuptools==68.2.2
# 再安装目标包
pip install 你的包名称

3. 临时绕过路径检查（应急用） #

找到报错的util.py文件（路径为C:\Users\username\AppData\Local\Temp\pip-build-env-1u7gh_7i\overlay\Lib\site-packages\setuptools_distutils\util.py），修改其中的convert_path函数：

# 注释掉绝对路径检查的代码块
# if os.path.isabs(pathname):
#     raise ValueError("path '%s' cannot be absolute" % pathname)

修改后重新执行pip install命令即可。注意：临时目录会在安装结束后被自动清理，下次安装需要重复操作，不推荐作为长期解决方案。

4. 联系包作者修复 #

如果是公开的第三方包，你可以向包作者提交issue，告知其配置中硬编码绝对路径的问题，请求适配跨平台路径规范。

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