Python自定义Union类型变量用于类型标注遭Pylance报错，求解决方案

你遇到的问题是因为Pylance默认不会把普通变量识别为类型别名，直接用MY_CUSTOM_TYPE = Type1 | Type2 | Type3会被判定为“类型表达式中不允许使用变量”。这里有几种靠谱的解决方式：

方法1：用TypeAlias注解标记类型别名（Python 3.10+） #

通过typing.TypeAlias（Python 3.9及以下版本可使用typing_extensions.TypeAlias）明确告诉类型检查器这是一个类型别名：

from typing import TypeAlias
from package1 import Type1 
from package2 import Type2
from package3 import Type3

MY_CUSTOM_TYPE: TypeAlias = Type1 | Type2 | Type3

def process(x: MY_CUSTOM_TYPE):
    # 业务逻辑代码
    pass

方法2：用Python 3.12+的type关键字定义类型别名 #

Python 3.12引入了更简洁的类型别名语法，直接用type关键字声明，类型检查器能直接识别：

from package1 import Type1 
from package2 import Type2
from package3 import Type3

type MY_CUSTOM_TYPE = Type1 | Type2 | Type3

def process(x: MY_CUSTOM_TYPE):
    # 业务逻辑代码
    pass

方法3：直接在参数中写联合类型（适合仅单次使用的场景） #

如果这个联合类型只在少数地方用到，也可以直接把Type1 | Type2 | Type3写在参数注解里，省去别名定义：

from package1 import Type1 
from package2 import Type2
from package3 import Type3

def process(x: Type1 | Type2 | Type3):
    # 业务逻辑代码
    pass

这些方法都能让Pylance正确识别你的类型约束，在传入非预期类型时给出警告，同时保持代码的可读性和复用性。

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