itertools.pairwise向后兼容实现与Pylance可疑类型警告解决问询

以下是几种无需使用#type: ignore的解决方案：

1. 基于Python版本的条件导入 #

直接通过版本判断选择导入原生函数或定义自定义函数，Pylance能识别版本分支的类型信息：

import sys
import itertools
from typing import Iterable, Tuple, Zip, TypeVar

T = TypeVar("T")

if sys.version_info >= (3, 10):
    from itertools import pairwise as _pairwise
else:
    def _pairwise(iterable: Iterable[T]) -> Zip[Tuple[T, T]]:
        a, b = itertools.tee(iterable)
        next(b, None)
        return zip(a, b)

这种方式让类型检查器明确不同版本下_pairwise的来源，不会触发类型不匹配警告。

2. 显式指定函数类型注解 #

给_pairwise提前定义统一的类型签名，让Pylance确认原生函数和自定义函数都符合该类型：

import itertools
from typing import Iterable, Tuple, Zip, Callable, TypeVar

T = TypeVar("T")
PairwiseFunc = Callable[[Iterable[T]], Zip[Tuple[T, T]]]

_pairwise: PairwiseFunc

try:
    _pairwise = itertools.pairwise  # 类型检查器会确认原生函数符合定义的类型
except AttributeError:
    def _pairwise(iterable: Iterable[T]) -> Zip[Tuple[T, T]]:
        a, b = itertools.tee(iterable)
        next(b, None)
        return zip(a, b)

通过提前声明类型，消除了类型不匹配的疑虑。

3. 使用typing.cast强制类型匹配 #

如果偏好try-except写法，可以用cast告诉类型检查器原生pairwise的类型与自定义函数一致：

import itertools
from typing import Iterable, Tuple, Zip, Callable, TypeVar, cast

T = TypeVar("T")
PairwiseFunc = Callable[[Iterable[T]], Zip[Tuple[T, T]]]

try:
    _pairwise = cast(PairwiseFunc, itertools.pairwise)
except AttributeError:
    def _pairwise(iterable: Iterable[T]) -> Zip[Tuple[T, T]]:
        a, b = itertools.tee(iterable)
        next(b, None)
        return zip(a, b)

cast相当于给类型检查器明确提示，避免它因无法识别原生函数类型而报错。

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