类型引擎
PyCharm 依赖类型引擎为依赖类型信息的 代码洞察功能提供支持,包括:
类型推断
与类型相关的诊断和检查
快速文档
推断类型的嵌入提示
基于推断类型的代码补全建议
默认情况下,PyCharm 使用其 内置类型引擎。 也可切换到 外部类型引擎 ,将类型分析委托给针对大型 Python 代码库优化的专用工具。
内置类型引擎
内置类型引擎会基于 类型提示 (PEP 484 )、类型注释、 存根和文档字符串,结合 PyCharm 对未注解代码的类型推断,分析您的代码。 开箱即用,无需额外设置,支持所有解释器配置,包括本地、虚拟环境、Docker、Docker Compose、WSL、SSH 及多模块项目。
外部类型引擎
外部类型引擎是 PyCharm 用于委托类型分析的第三方类型检查器。 启用后,外部引擎会在编辑器中提供类型推断和类型相关诊断,并在这些功能上取代内置类型引擎。   只有在 类型引擎设置 中启用后,才会提供快速文档和嵌入提示。
Pyrefly
Pyrefly 是用 Rust 编写的 Python 类型检查器。 提供快速类型检查,并支持 Django 和 Pydantic。
切换到 Pyrefly 作为类型引擎
打开一个 Python 文件,然后点击状态栏中的 类型: 内置字符串 微件。
请选择 Pyrefly。 如果未安装 Pyrefly,请选择 安装并使用 Pyrefly。
要检查 Pyrefly 版本,请将鼠标悬停在状态栏中的 Pyrefly 图标上。
配置类型引擎
转到 。
对于 类型引擎 ,请选择 内置 或 Pyrefly。
要让 Pyrefly 也提供嵌入提示和快速文档,请展开 其他功能 并选择 内联提示 和 文档注释。 默认情况下,两个复选框均未选中。
2026年 11月 3日