
JetBrains 发布 PyCharm 2026.3,包含 303 项修复与改进
来源标题:What’s Fixed and Improved in PyCharm 2026.3
JetBrains 发布 PyCharm 2026.3,该版本除 JetBrains Air、工作区、Python 3.15 惰性导入和重新设计的解释器控件等主要功能外,还包含 303 项针对日常 Python 开发的修复与改进。改进涵盖更智能的代码补全、更可靠的环境与调试,以及 functools.partial 的类型推断支持,并修复了十多年前报告的问题。
以下正文由 AI 翻译自 JetBrains Blog(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
PyCharm 2026.3 来了!除了 JetBrains Air、workspaces、Python 3.15 lazy imports 和重新设计的解释器小部件等主要功能外,此版本还包含 303 项针对日常 Python 开发的修复和改进。
从更智能的代码补全到更可靠的环境和调试,以下是一些值得了解的变更——包括对十多年前报告的问题的修复。
更智能的代码洞察与类型推断
更好地支持 functools.partial
functools.partial 允许你通过预先提供函数的某些参数来创建新的可调用对象。此前,PyCharm 可能难以推断生成的签名,导致缺少参数信息和产生错误的警告。
PyCharm 现在能够理解剩余参数、检查其类型,并将 partial 对象识别为有效的 Callable 实例。在下面的示例中,PyCharm 正确识别了剩余参数,并标记出不兼容的参数。
PyCharm 能够理解 functools.partial 对象的剩余参数。
这解决了与补全、参数信息和类型检查相关的多个长期存在的问题(PY-35363、PY-33618、PY-25698、PY-36385)。
减少泛型和集合的误报
PyCharm 现在对泛型类、有界和受约束的类型变量、重载构造函数以及泛型 getattr 方法提供更准确的类型推断。例如,在有界类型变量上调用方法时,现在会保留其返回类型,而不是回退到 Any(PY-89863)。
集合推断也得到了改进。嵌套列表、可选值、字典字面量和元组解包产生的错误警告更少(PY-89564、PY-91999)。此外还改进了对 Literal、Enum 和 TypedDict 的支持,并支持 PEP 747 的 TypeForm[T] 以及通过 ty_extensions.Intersection 实现的交集类型(PY-90287、PY-62524、PY-89043、PY-87024)。
更清晰的类型警告和抑制注释
当 PyCharm 发现类型不匹配时,其工具提示现在会提供更清晰的解释、改进的格式以及指向相关类型的链接。调用和控制流分析也能处理更多涉及可选可调用对象、绑定方法和永不返回路径的情况,从而减少错误警告(PY-90555、PY-83644)。
当警告是有意为之的,你可以更好地控制如何抑制它。PyCharm 现在支持 # type: ignore[...] 注释中的简短代码,并引入了用于单个 PyCharm 检查的 # pycharm: ignore[...]。此外还新增了 Suppress with 'type: ignore' comment 操作,未知的抑制代码会被标记出来以捕获拼写错误(PY-90787、PY-92114)。
PyCharm 2026.3 引入了一个新操作,可使用 # type: ignore[...] 注释抑制单个类型警告。
测试与开发者工具
更好的 pytest 和 mock 补全
Mock 和 fixture 对 IDE 来说可能难以理解。PyCharm 现在为 pytest-mock 的 mocker fixture 提供补全,为 mocker.patch() 的目标提供导航,并基于传递给 Mock(spec=...) 或 Mock(spec_set=...) 的类提供补全。
from unittest.mock import Mock
class Client:
def fetch(self, url: str) -> str:
return "OK"
client = Mock(spec=Client)
client.fetch("https://example.com")
PyCharm 2026.3 为传递给 Mock(spec=...) 的类中定义的方法提供补全。
PyCharm 还会标记无效的 unittest.mock.patch() 目标,并改进 pytest fixture 的补全和文档(PY-36260、PY-32282)。
对于拥有自定义测试基础设施的项目,你可以配置 unittest 运行器脚本,例如 Django 的 tests/runtests.py。如果它使用 unittest.TextTestRunner,测试结果将显示在 PyCharm 的测试树中(PY-26068)。
更强大的类型检查器和 Ruff 集成
Zuban 是一个兼容 mypy 的类型检查器和语言服务器,它加入了 ty、Pyrefly 和 basedpyright 的行列,成为受支持的外部工具。其集成提供诊断、补全、悬停信息、内联提示和快速修复。Pyrefly 也获得了针对自定义导入根和缺失包安装的修复(PY-85009、PY-89805)。
对于 Ruff,Optimize Imports 现在会移除未使用的导入并对其进行整理。Ruff 修复可以在保存时或提交前自动运行,新的 Apply Ruff Fixes 操作可在选定范围内工作,包括整个项目。在多根、网络和 WSL 项目中,配置发现也更加可靠(PY-85534、PY-86352)。
直接从 PyCharm 对单个文件、自定义范围或整个项目应用 Ruff 修复。
Django、FastAPI 和 SQLAlchemy
Django:你可以为 Django 6.0 任务创建运行配置,使用 value-and-label 元组定义的 TextChoices 成员不再触发错误的类型错误(PY-86368、PY-92177)。
在 Django REST framework 中,rest_framework.reverse.reverse() 现在提供 URL 名称补全和导航,就像 Django 内置的 reverse() 一样(PY-78900)。
PyCharm 2026.3 为 Django REST framework 的 reverse() 函数提供 URL 名称补全。
FastAPI:除了新的交互式依赖图之外,通过依赖提供的路径参数不再导致关于缺少端点参数的错误警告(PY-88935)。
SQLAlchemy:扩展的 ORM 支持改进了声明式模型的补全、导航和类型推断。修复还涵盖了通过 relationship() 添加的属性和使用 SQLAlchemy 的 ENUM 类型的列(PY-79736、PY-29212)。
编辑与重构
几个小修复使编辑更加可预测。在引入代码块的注释后按 Enter 现在会插入正确的缩进,而在使用制表符缩进的文件中移动行不再导致错误的 Unexpected indent 警告(PY-15693、PY-78251)。
新的 Align consecutive assignments 格式化选项会对齐赋值运算符。你可以在 Settings | Editor | Code Style | Python | Wrapping and Braces 下启用它。格式化器在保留配置的空行方面也做得更好(PY-34006)。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。