如何处理外部库引发的VSCode Pylance类型提示错误？

这类报错的核心原因是开启了strict级别的类型检查，但引用的第三方库本身没有内置符合PEP 561规范的完整类型标注（缺少py.typed标记或配套的.pyi类型存根文件），Pylance无法推导出完整类型就会抛出对应提示。有两类合规方案可以在不放弃自有代码严格校验的前提下消除这类提示：

方案1：补全第三方库的类型存根 #

主流Python库的类型标注一般有两种提供形式：

• 库本身在新版本中内置完整类型标注：这种情况直接把库升级到最新稳定版即可
• 官方未内置、由Python类型社区维护独立类型存根包：这类包统一以types-为前缀，直接通过pip安装即可
  • numpy对应类型包：执行pip install types-numpy，安装后即可正确推导ndarray等对象的完整类型，消除ndarray[Unknown, Unknown]提示
  • slack-sdk对应类型包：执行pip install types-slack-sdk，安装后WebClient的方法参数、返回值类型均可被正确识别，消除方法部分未知的提示

方案2：针对性放宽第三方库相关的检查规则 #

如果使用的是小众库、没有对应的类型存根，可以通过配置调整，只放宽和外部无类型库相关的检查项，不影响自有业务代码的严格类型校验：

全局配置方式 #

在VSCode的settings.json中添加如下配置项，覆盖严格模式下的对应检查等级：

"python.analysis.diagnosticSeverityOverrides": {
    "reportUnknownMemberType": "none",
    "reportUnknownArgumentType": "none",
    "reportUnknownVariableType": "none",
    "reportMissingTypeStubs": "warning"
}

配置后Pylance不会再因为第三方库缺少类型标注抛出未知类型的错误，自己写的代码里的类型不匹配、缺少返回值类型等严格检查规则依然生效。

单行忽略方式 #

如果不想全局放宽规则，可以在报错行的上一行添加类型忽略注释，只跳过对应行的检查，颗粒度更灵活：

• slack调用示例：

from slack.web.client import WebClient

def send_message(client: WebClient, channel:str, text:str) -> None:
    # 忽略当前行成员类型未知的报错
    # type: ignore[reportUnknownMemberType]
    res = client.chat_postMessage(
        channel=channel,
        text=text
    )

• numpy调用示例：

import numpy as np
# 忽略当前行变量类型未知的报错
# type: ignore[reportUnknownVariableType]
array = np.linspace(0,5,5)

不建议直接将python.analysis.typeCheckingMode从strict调整为basic，该操作会关闭大量自有代码的严格类型校验规则，失去严格类型检查的意义。

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