如何为RPi.GPIO生成Python存根接口，实现跨平台开发？

一、生成RPi.GPIO的Python存根接口 #

1. 自动生成存根的工具 #

• pybind11-stubgen：专为C/C++编写的Python扩展生成存根文件，支持扫描编译后的.so模块或源码。安装后直接执行命令即可提取接口：

  pybind11-stubgen RPi.GPIO
  

  它会自动识别模块中的类、函数、常量，生成.pyi格式的存根文件。把这些存根放到项目路径或Python的site-packages目录，IDE就能识别接口并提供代码补全。
• stubgen（mypy内置工具）：mypy自带的存根生成工具，同样支持扩展模块，生成的存根包含类型注解，对IDE更友好：

  stubgen -m RPi.GPIO
  

2. 手动补充存根（自动生成有缺失时） #

如果自动工具提取不完整，可参考RPi.GPIO的官方文档手动编写RPi/GPIO.pyi存根文件，示例如下：

def setmode(mode: int) -> None: ...
def setup(channel: int, direction: int, initial: int = ...) -> None: ...
def output(channel: int, value: int) -> None: ...
# 按原库接口补充其余函数、常量定义

这类存根无需实现逻辑，仅定义接口签名即可满足IDE识别需求。

二、发布跨平台pip包 #

要让pip根据系统自动选择安装原库或存根包，需利用PEP 508环境标记配置项目：

1. 项目结构 #

rpi-gpio-stub/
├── RPi/
│   ├── __init__.py
│   └── GPIO.py  # 存根实现，所有函数做空操作或返回默认值
├── pyproject.toml
└── setup.py

2. 配置依赖规则 #

在setup.py中指定平台依赖，仅树莓派（Linux ARM架构）安装原RPi.GPIO库，其他系统安装存根：

from setuptools import setup

setup(
    name="RPi.GPIO-stub",
    version="0.1.0",
    packages=["RPi"],
    install_requires=[
        "RPi.GPIO; platform_machine in ['armv6l', 'armv7l', 'aarch64']"
    ],
    author="你的名字",
    description="RPi.GPIO的跨平台存根包，用于非树莓派设备开发",
)

也可以用pyproject.toml简化配置：

[project]
name = "RPi.GPIO-stub"
version = "0.1.0"
dependencies = [
    "RPi.GPIO; platform_machine in ['armv6l', 'armv7l', 'aarch64']"
]
authors = [{name = "你的名字"}]
description = "RPi.GPIO的跨平台存根包，用于非树莓派设备开发"

3. 存根包的实现示例 #

存根包的GPIO.py可写空实现，避免运行时报错：

def setmode(mode):
    pass

def setup(channel, direction, initial=None):
    pass

def output(channel, value):
    pass

# 定义原库中的常量
BCM = 11
BOARD = 10
IN = 0
OUT = 1
# 补充其余常量

4. 发布到PyPI #

• 先安装构建和上传工具：

  pip install twine build
  

• 构建包文件：

  python -m build
  

• 上传到PyPI：

  twine upload dist/*
  

用户执行pip install RPi.GPIO-stub时，pip会自动根据当前系统架构选择安装原库或存根版本。

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