如何通过pip分发原生二进制可执行文件？

针对你想通过pip分发原生二进制（类似pip install cmake的效果）的需求，下面分问题解答：

1. 能否用现有工具（setuptools、python -m build等）实现？ #

完全可以，核心思路是用Python包装脚本作为入口，配合setuptools将原生二进制打包进wheel，具体步骤如下：

• 准备Python包装脚本
  写一个极简的Python脚本（比如my_binary_wrapper.py），负责定位并执行打包好的原生二进制：

  import os
  import sys
  from subprocess import run
  
  def main():
      # 根据实际打包路径调整二进制文件的位置
      binary_path = os.path.join(os.path.dirname(__file__), "bin", "my-native-binary")
      # 传递命令行参数并启动二进制程序
      run([binary_path] + sys.argv[1:], check=True)
  
  if __name__ == "__main__":
      main()
  

• 配置pyproject.toml
  在配置文件中，用[project.scripts]指向包装脚本的入口函数，同时通过setuptools的package-data将原生二进制纳入打包范围：

  [build-system]
  requires = ["setuptools>=61.0"]
  build-backend = "setuptools.build_meta"
  
  [project]
  name = "my-native-package"
  version = "0.1.0"
  scripts = { "my-native-binary" = "my_binary_wrapper:main" }
  
  [tool.setuptools.package-data]
  "" = ["bin/*"]
  

  注：跨平台打包时，需为每个平台单独构建wheel，仅包含对应平台的二进制文件。Linux平台可配合auditwheel处理依赖，生成符合manylinux标准的可移植wheel；Mac平台用delocate处理动态链接库。

• 构建平台特定wheel
  执行python -m build --wheel构建时，确保只打包当前平台的二进制文件。可通过环境变量或辅助脚本自动切换不同平台的二进制源。

2. 自行编写构建工具是否可行？ #

理论上完全可行。wheel本质是符合PEP 491规范的ZIP文件，你可以：

• 生成符合平台命名规则的wheel文件名（例如my-native-package-0.1.0-cp38-abi3-manylinux_2_17_x86_64.whl）
• 按规范组织wheel内部文件结构，将原生二进制放置到合适目录（如bin/）
• 编写安装入口脚本（或利用wheel的RECORD文件记录路径）
• 处理不同平台的兼容性细节（如文件权限、动态链接库依赖）

不过自行实现需要深入理解PEP 491和pip的安装逻辑，相比现有工具方案会更繁琐，除非有特殊定制需求，否则优先选择setuptools+包装脚本的方案。

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