VSCode报reportMissingImports错误但代码运行正常的原因排查

原因 #

• requests将urllib3打包在内部的requests.packages目录下，这属于内部实现细节，并非requests官方公开的API路径。VSCode的Python语言服务（比如Pylance）做静态代码检查时，只会依据公开的包结构和类型提示文件判断，不会像Python运行时那样动态加载验证，因此误判为导入路径不存在。
• 静态分析工具和Python运行时的模块查找逻辑有差异：运行时会直接读取实际安装包的文件结构，只要路径存在就能导入；但静态检查是基于预定义的包结构规则，对这种内部嵌套的非公开路径识别不足。

解决方法 #

方法1：改用urllib3官方公开路径导入（推荐） #

requests.packages.urllib3本质就是项目依赖的urllib3包，直接从urllib3的标准路径导入，既能符合API规范，也能让静态分析工具正确识别：

import requests
from requests.adapters import HTTPAdapter
# 替换原导入语句
from urllib3.util.ssl_ import create_urllib3_context

方法2：配置静态分析工具识别内部路径 #

如果必须保留原导入方式，可在项目根目录创建pyrightconfig.json文件，添加extraPaths指定requests内部packages的实际路径（替换为你自己的虚拟环境路径）：

{
  "extraPaths": ["./venv/lib/python3.10/site-packages/requests/packages"]
}

这样VSCode的语言服务会把该路径加入模块搜索范围，消除错误提示。

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