PyDrake依赖项目中Mypy触发语法错误的解决咨询

核心原因 #

PyDrake在类型注解中使用了自定义泛型语法（类似Python 3.12+的PEP 695泛型语法），但你的Mypy 0.991版本对该语法支持不完善，导致解析.pyi文件时抛出语法错误。

具体解决方案 #

1. 升级Mypy到支持PEP 695的版本 #

Mypy从1.0.0版本开始正式支持PEP 695泛型语法，执行以下命令升级：

pip install --upgrade mypy>=1.0.0

2. 配置Mypy忽略PyDrake类型文件（临时方案） #

若暂时无法升级Mypy，可在项目配置文件中让Mypy跳过PyDrake库的类型检查：

• 使用mypy.ini时添加：

[mypy]
exclude = venv/lib/python3.9/site-packages/pydrake/

• 使用pyproject.toml时添加：

[tool.mypy]
exclude = ["venv/lib/python3.9/site-packages/pydrake/"]

注意：此方法会丢失PyDrake的类型提示，但能快速解决语法错误。

3. 升级Python版本（可选） #

若项目允许，升级到Python 3.12+，原生支持PEP 695泛型语法，配合新版Mypy能获得更完善的兼容性。

验证 #

修改配置或升级后，重新运行Mypy验证：

mypy your_project_directory/

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