PyCharm 2026.2 Help

类型引擎

PyCharm 依赖类型引擎为依赖类型信息的 代码洞察功能提供支持,包括:

  • 类型推断

  • 与类型相关的诊断和检查

  • 快速文档

  • 推断类型的嵌入提示

  • 基于推断类型的代码补全建议

默认情况下,PyCharm 使用其 内置类型引擎。 也可切换到 外部类型引擎 ,将类型分析委托给针对大型 Python 代码库优化的专用工具。

内置类型引擎

内置类型引擎会基于 类型提示PEP 484 )、类型注释、 存根和文档字符串,结合 PyCharm 对未注解代码的类型推断,分析您的代码。 开箱即用,无需额外设置,支持所有解释器配置,包括本地、虚拟环境、Docker、Docker Compose、WSL、SSH 及多模块项目。

外部类型引擎

外部类型引擎是 PyCharm 用于委托类型分析的第三方类型检查器。 启用后,外部引擎将为编辑器中的类型推断、类型相关诊断、快速文档和嵌入提示提供支持,替代这些功能的内置类型引擎。

Pyrefly

Pyrefly 是用 Rust 编写的新一代 Python 类型检查器。 作为外部类型引擎,Pyrefly 能大幅提升 PyCharm 在大型项目中的代码洞察功能性能。

切换到 Pyrefly 作为类型引擎

  1. 点击状态栏中的 按类型分组 小组件。 默认情况下,该小组件表示正在使用内置类型引擎。

  2. 在列表中选择 Pyrefly。 如果尚未安装 Pyrefly,PyCharm 会自动安装。

  3. Pyrefly 激活后,其图标会显示在状态栏中。 将鼠标悬停在图标上可查看正在使用的版本。

可在 设置 | Python | 类型引擎 中配置 Pyrefly 的可执行文件位置和启用的功能等设置。

2026年 7月 14日