安装带ec2/s3扩展的boto3-stubs后mypy报无boto3类型存根,该如何配置?
适配mypy识别boto3-stubs的配置方案
核心触发原因
当前使用的版本组合(Python 3.8.6、mypy 0.790、boto3/boto3-stubs 1.16.59)存在版本兼容缺口:mypy 0.790是较早的版本,对随pip安装到site-packages下的第三方类型存根,没有开启自动检索逻辑。哪怕boto3-stubs和boto3版本完全对齐、装在同一个虚拟环境里,这个版本的mypy也找不到对应的存根文件,最终报出“found module but no type hints or library stubs”的错误。
具体配置操作
- 先确认虚拟环境的检索路径正确
激活项目虚拟环境后,执行python -c "import site; print(site.getsitepackages()[0])",拿到当前虚拟环境site-packages目录的绝对路径,排查有没有全局Python的包路径抢在虚拟环境路径前面被mypy检索的异常。 - 在项目根目录新建
mypy.ini配置文件,写入适配当前版本的规则:[mypy] # 显式告诉mypy去哪找类型存根 mypy_path = <上面获取到的site-packages绝对路径> # 开启明确的包路径解析逻辑,避免跨路径导错模块 explicit_package_bases = True # 不要默认忽略缺失导入的模块,要正常校验存根 ignore_missing_imports = False [mypy-boto3.*] # 对所有boto3相关的模块,跟随正常导入逻辑匹配存根 follow_imports = normal ignore_missing_imports = False
验证与注意事项
- 配置完成后重新执行
mypy .,就能正常识别boto3核心模块、以及带ec2、s3扩展的类型存根,不会再出现存根缺失的报错。 - 当前安装的boto3和boto3-stubs版本完全对齐,不需要调整包版本,不存在存根和运行时模块不匹配的问题。
- 如果后续升级mypy到0.810及以上版本,可以删掉
mypy.ini里手动写的mypy_path路径——新版本mypy会自动检索标准路径下安装的boto3-stubs,不需要手动配路径。
内容的提问来源于stack exchange,提问作者Eloff
相关产品推荐
相关产品推荐

