VS Code中Python多类型类型提示报错，求正确编写方式

正确的类型提示写法 #

Python 3.10+ 版本 #

直接使用竖线联合类型语法：

def get_resource_file(use_wildcard: str | bool = False) -> list[str]:
    # 显式判断变量类型，消除类型检查器歧义
    if isinstance(use_wildcard, bool):
        # 处理布尔值逻辑
        return ["all_files"] if use_wildcard else []
    else:
        # 处理字符串通配符逻辑
        return [f for f in ["a.txt", "b.jpg"] if f.endswith(use_wildcard.lstrip("*."))]

Python 3.9及更早版本 #

从typing模块导入Union：

from typing import Union

def get_resource_file(use_wildcard: Union[str, bool] = False) -> list[str]:
    if isinstance(use_wildcard, bool):
        return ["all_files"] if use_wildcard else []
    else:
        return [f for f in ["a.txt", "b.jpg"] if f.endswith(use_wildcard.lstrip("*."))]

报错的常见原因及修复 #

• 缺失类型导入：使用Union时未从typing（Python3.9-）或types（Python3.9+）导入，会引发语法错误，确保导入语句正确。
• 无类型分支判断：如果函数内没有用isinstance显式区分bool和str分支，Pylance等类型检查器会认为后续代码中变量类型不明确，从而抛出提示。必须添加类型判断分支，明确每个分支的变量类型。
• 严格类型检查模式：VS Code的python.analysis.typeCheckingMode若设为strict，会触发更严格的类型校验。如果不想调整模式，就需要补充完整的类型注解和分支判断来满足严格要求。

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