如何仅安装PyPI包的类型存根（stubs）以实现快速类型检查？

以下是几种可行的解决思路，覆盖不同场景的需求：

1. 手动维护存根依赖清单 #

• 创建专门的requirements-stubs.txt文件，列出项目依赖对应的独立存根包（比如types-requests、scipy-stubs）。
• 在CI流程中先执行pip install -r requirements-stubs.txt，再运行mypy。
• 优势：完全避免安装完整包，速度最快；缺点：需要手动同步依赖变更，当项目新增或更新依赖时，要记得补充对应的存根包。

2. 基于typeshed和自定义存根路径构建无依赖检查环境 #

• 直接从typeshed仓库获取官方维护的存根，再补充第三方存根到自定义目录，让mypy仅使用这些存根进行检查：
  1. 在CI中克隆typeshed仓库到本地（比如git clone https://github.com/python/typeshed.git ./typeshed，可指定特定版本避免兼容性问题）。
  2. 对于typeshed中没有的存根，单独下载对应的stub包到自定义目录（比如pip install scipy-stubs --target ./custom-stubs）。
  3. 在mypy.ini或命令行中配置存根路径：

     [mypy]
     stubpath = ./custom-stubs:./typeshed/stubs
     

  4. 运行mypy时加上--no-site-packages参数，强制mypy不使用系统/site-packages中的包，只依赖指定的存根。
• 优势：彻底脱离对完整依赖包的依赖；缺点：需要处理存根版本与项目依赖版本的匹配，配置稍复杂。

3. 优化完整包安装速度（针对无独立存根的依赖） #

• 对于那些没有独立存根、只能通过安装完整包获取类型信息的依赖，用pip参数加速安装：
  • 使用--only-binary :all:强制安装预编译wheel包，避免源码编译的耗时。
  • 配合--no-deps跳过依赖包的安装，只安装目标包本身。
  • 示例命令：pip install --only-binary :all: --no-deps pandas
• 优势：不需要额外维护存根，适合依赖包本身体积不大的场景；缺点：还是会安装完整包，但速度比常规安装快很多。

4. 选择性跳过非核心依赖的类型检查 #

• 如果某些依赖的类型检查对项目质量影响不大，可以用mypy参数跳过它们：
  • --ignore-missing-imports：忽略找不到的导入模块的错误。
  • --follow-imports=skip：不追踪导入的模块，只检查当前项目代码。
  • 示例：mypy --ignore-missing-imports --follow-imports=skip your_project/
• 优势：配置最简单，速度最快；缺点：会降低类型检查的全面性，仅适合临时或非核心场景。

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