使用Poetry构建含系统专属依赖的包，安装时能否保留依赖规则？

核心结论 #

可以保留系统特定依赖规则，但需要确保配置、Wheel构建方式和pip版本满足要求，以下是具体解决步骤：

问题原因分析 #

你的元数据已保留规则但pip不生效，大概率是这几个原因：

• 构建了通用Wheel（universal wheel），这类Wheel不携带平台特定的依赖约束
• pip版本过低，对环境标记（markers）的支持不完整
• 间接依赖的约束（如geopandas对Fiona的依赖）覆盖了你的自定义规则

解决步骤 #

1. 修正pyproject.toml的依赖配置 #

直接指定Fiona/GDAL的系统特定规则，并覆盖geopandas的默认依赖约束：

[tool.poetry.dependencies]
python = "^3.8"
geopandas = "^0.13"
# 直接定义Fiona的系统依赖规则
fiona = [
    { version = ">=1.9,<2.0", markers = "sys_platform != 'win32'" },
    { url = "https://download.lfd.uci.edu/pythonlibs/s2jqpv5t/Fiona-1.9.4-cp311-cp311-win_amd64.whl", markers = "sys_platform == 'win32'" }
]
# 对GDAL做同样处理（如果需要）
gdal = [
    { version = ">=3.6,<4.0", markers = "sys_platform != 'win32'" },
    { url = "https://download.lfd.uci.edu/pythonlibs/s2jqpv5t/GDAL-3.6.4-cp311-cp311-win_amd64.whl", markers = "sys_platform == 'win32'" }
]

# 强制覆盖geopandas的依赖约束，避免冲突
[tool.poetry.overrides]
fiona = [
    { version = ">=1.9,<2.0", markers = "sys_platform != 'win32'" },
    { url = "https://download.lfd.uci.edu/pythonlibs/s2jqpv5t/Fiona-1.9.4-cp311-cp311-win_amd64.whl", markers = "sys_platform == 'win32'" }
]
gdal = [
    { version = ">=3.6,<4.0", markers = "sys_platform != 'win32'" },
    { url = "https://download.lfd.uci.edu/pythonlibs/s2jqpv5t/GDAL-3.6.4-cp311-cp311-win_amd64.whl", markers = "sys_platform == 'win32'" }
]

2. 构建平台特定的Wheel #

不要构建通用Wheel，确保生成的Wheel包含平台信息：

• 检查pyproject.toml中没有[tool.poetry] universal = true的配置（如果有则删除）
• 执行构建命令：

  poetry build --format wheel
  

  生成的Wheel文件名应该类似your_package-0.1.0-cp311-cp311-win_amd64.whl（Windows）或your_package-0.1.0-cp311-cp311-manylinux_2_17_x86_64.whl（Linux），而非py3-none-any.whl。

3. 升级Windows上的pip版本 #

pip 20.0及以上才完整支持环境标记的解析，执行升级：

python -m pip install --upgrade pip

4. 验证Wheel元数据 #

用wheel inspect命令确认依赖规则已正确嵌入Wheel：

wheel inspect dist/your_package-0.1.0-cp311-cp311-win_amd64.whl

查看输出中的requires_dist字段，应该能看到带sys_platform标记的依赖项，比如：

"fiona @ https://download.lfd.uci.edu/pythonlibs/s2jqpv5t/Fiona-1.9.4-cp311-cp311-win_amd64.whl ; sys_platform == 'win32'"

5. 测试安装（清理缓存避免干扰） #

先清理pip缓存，再安装你的Wheel：

pip cache purge
pip install dist/your_package-0.1.0-cp311-cp311-win_amd64.whl

此时pip应该会自动拉取你指定的预编译whl，而非源码包。

额外注意事项 #

• 确保预编译whl的Python版本、系统架构和目标环境完全匹配（比如cp311对应Python 3.11，win_amd64对应64位Windows）
• 虽然LFD仓库已归档，但只要链接可用就能正常使用，后续可以考虑替换为其他预编译源

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