Hacktoberfest 2026：维护者为十月标记出来的 issue，仍然开放、适合新手。 浏览 Hacktoberfest issue

Type expression arguments aren't recognized as `TypeForm` when the parameter type is a union containing a `TypeForm`

未关闭
#21,964 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
55/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
活跃
技术栈
python
领域
devtools

调研方向

从 issue 中的最小复现开始，比较直接的 TypeForm 参数与 union 中的 TypeForm，包括 Optional 和字符串注解。跟踪 mypy 的调用参数分析，然后添加回归测试，确认这些参数能够被识别，并在没有不兼容诊断的情况下显示预期类型。

由索引模型根据 Issue 内容生成。

描述

bug topic-type-form

A type expression passed as a call argument is only recognized as a TypeForm when the parameter type is exactly TypeForm[...]. With a union such as TypeForm[T] | None, the argument is evaluated as a value expression instead.

from typing import Annotated, TypeVar
from typing_extensions import TypeForm

T = TypeVar('T')

def f(t: TypeForm[T]) -> T: ...
def g(t: TypeForm[T] | None) -> T: ...

reveal_type(f(Annotated[int, 'meta']))  # int
reveal_type(g(Annotated[int, 'meta']))  # Argument 1 to "g" has incompatible type "<typing special form>"; expected "TypeForm[Never] | None"  [arg-type]

The same happens with int | str, Literal[...], Optional[...] or a string annotation. Assigning the same expression to a variable annotated TypeForm[int] | None works, so this is specific to call arguments.

Playground: https://mypy-play.net/?mypy=latest&python=3.14&gist=9ccf3597617fe30ec3d718ee9cdb1d9d.

Your Environment

  • Mypy version used: 2.3.1
  • Python version used: 3.14
主要语言
Python
星标
20.6k
派生
3.3k
平均合并
1 天 3 小时
30 天内合并 PR
60

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

python/mypy 的其他 Issue

查看 python/mypy 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。