本文旨在深入探讨python中`mypy`工具在处理自定义类时可能出现的“the type type[array] is not generic and not indexable”错误。我们将分析该错误产生的根本原因——`__class_getitem__`方法的误用，它专为类型提示和泛型类设计。文章将提供正确的代码实现方式，并强调在python中遵循特殊方法（dunder methods）的既定用途的重要性，以避免潜在的类型检查问题和运行时错误。

理解Mypy错误：Type[Array]非泛型且不可索引

在使用Python进行类型检查时，mypy是一个非常有用的工具，它能帮助我们在代码运行前发现潜在的类型不匹配问题。然而，当我们尝试以非预期的方式使用某些Python特性时，mypy可能会抛出看似令人困惑的错误。其中一个常见的情况是，当一个类并非泛型，但我们却尝试对其使用索引语法（如Array["int"]）时，mypy会报错：“The type "Type[Array]" is not generic and not indexable”。

考虑以下示例代码，它尝试定义一个Array类，并使用__class_getitem__方法来模拟“可爱”的语法，以便将数组类型作为参数传递：

class Array:
    def __init__(self, underlying):
        self.underlying = underlying

    # 尝试使用 __class_getitem__ 实现 Array["int"] 这样的语法
    def __class_getitem__(cls, key):
        return Array(key)

    def __getitem__(self, key):
        pass

    def __str__(self):
        return f"Array(underlying={self.underlying})"

def foo(name, kind):
    print(f"Name: {name}, Kind: {kind}")

# 尝试使用 Array["int"] 语法
foo(name="x", kind=Array["int"])

当mypy检查这段代码时，会报告以下错误：

x.py:17: error: The type "Type[Array]" is not generic and not indexable  [misc]

这个错误明确指出，Array类型既不是泛型（generic），也无法被索引（indexable）。那么，为什么会出现这种情况呢？

__class_getitem__ 的真正用途

问题的核心在于对__class_getitem__方法的理解和使用。在Python中，__class_getitem__是一个特殊方法，它的设计目的是专门用于类型提示和泛型类的特化。根据Python官方文档，object.__class_getitem__(cls, key)方法应返回一个对象，该对象代表由key中类型参数特化的泛型类。

更具体地说，__class_getitem__方法使得我们可以像list[str]或dict[str, int]这样使用类，来创建类型提示，指示一个泛型类的特定类型参数版本。例如，typing.List或typing.Dict等泛型类型就是通过此机制实现类型参数化的。

Python文档明确指出：

强烈不鼓励在类型提示之外的任何类上使用 __class_getitem__()。

这意味着，如果你不打算将Array类注册为泛型类型（例如，通过继承typing.Generic并使用typing.TypeVar），那么mypy会认为你对__class_getitem__的调用是非法的。mypy作为类型检查器，其职责是确保代码符合类型系统的规则，因此它会阻止这种“滥用”。

Mypy如何强制执行

当mypy看到Array["int"]这样的语法时，它会首先检查Array是否是一个泛型类型。如果Array没有通过typing模块的机制被声明为泛型（例如，没有继承Generic），mypy就会认为Array是一个普通的类类型，而不是一个可以接受类型参数的泛型容器。在这种情况下，对一个非泛型类型使用索引语法[]是无效的，因此mypy会抛出“非泛型且不可索引”的错误。

即使你在Array类中定义了__class_getitem__，mypy也不会自动将其视为泛型类型。它需要明确的类型系统声明来识别泛型行为。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

正确的实现方式与替代方案

既然__class_getitem__不适用于非类型提示的“可爱语法”，那么我们应该如何实现将“数组类型”作为参数传递的需求呢？最直接和符合Python习惯的方式是使用常规的构造函数语法。

例如，如果你想传递一个表示“整数数组”的概念，你可以直接创建Array类的实例：

class Array:
    def __init__(self, underlying):
        self.underlying = underlying

    # 移除或不使用 __class_getitem__，因为它不符合我们的非类型提示目的

    def __str__(self):
        return f"Array(underlying={self.underlying})"

def foo(name, kind):
    print(f"Name: {name}, Kind: {kind}")

# 使用常规构造函数语法
foo(name="x", kind=Array("int"))

在这个修正后的代码中，Array("int")创建了一个Array类的实例，其underlying属性被设置为字符串"int"。这完全符合Python的面向对象编程范式，并且mypy也不会报告任何错误。

特殊方法（Dunder Methods）的使用规范

这个案例也引出了一个更广泛的Python编程最佳实践：特殊方法（即以双下划线开头和结尾的“dunder methods”，如__init__, __str__, __class_getitem__等）不应被用于未明确文档说明的用途。

Python官方文档明确指出：

任何在未遵循明确文档说明的情况下使用 __*__ 名称的行为，都可能在不发出警告的情况下导致程序中断。

这意味着，即使你发现了一个看似可以“巧妙”利用某个特殊方法来实现特定语法的机会，如果这种用法不在官方文档的允许范围内，那么你的代码在未来的Python版本中可能会出现兼容性问题，或者被工具（如mypy）标记为错误。遵循特殊方法的既定用途，是编写健壮、可维护和可预测Python代码的关键。

总结

当mypy报告“The type "Type[Array]" is not generic and not indexable”错误时，通常是因为你尝试在一个非泛型类上使用了__class_getitem__方法，而该方法是专门为类型提示和泛型特化设计的。解决此问题的最佳方法是：

1. 遵循__class_getitem__的用途：仅在你的类确实是泛型，并且你希望通过它提供类型提示时才使用此方法。
2. 使用常规构造函数：如果你的目的是为了传递一个配置或值，而不是一个类型，那么请使用常规的类构造函数（如Array("int")）来创建实例。
3. 遵守特殊方法规范：避免“滥用”特殊方法，只在它们明确的文档用途范围内使用它们，以确保代码的稳定性和兼容性。

通过理解这些原则，你将能够更有效地使用mypy进行类型检查，并编写出更符合Python语言习惯和规范的代码。