pyrefly
SHA-256极速 Python 类型检查器和语言服务器，经 Meta 2000 万行代码验证，速度是 Mypy/Pyright 的 15 倍，IDE 响应低于 10 毫秒，即装即用。
比 Mypy 快 15 倍的类型检查器，Instagram 在用，还能自动补全和导航代码。
核心功能
- 超高速检查：每秒处理 185 万行代码，是 Mypy 和 Pyright 的 15 倍
- 完整 IDE 支持：代码导航、自动补全、悬停信息、内联提示、语义高亮
- 原生框架支持：Pydantic 和 Django 开箱即用，模型验证与字段类型自动识别
- 无缝迁移：从 Mypy/Pyright 一键初始化，自动压制旧错误，逐步启用新检查
- 生产验证：Meta Instagram 2000 万行代码默认使用，PyTorch/JAX 等开源项目采用
避坑指南
- •Pyrefly 不遵循严格语义版本号，升级小版本可能引入新的类型错误，可使用 `pyrefly suppress` 命令一键静默升级后新增的错误。另外，部分非常规 Python 语法（如动态属性注入）可能无法完全覆盖。
适用场景
- 大型 Python 项目的类型检查和 IDE 增强，尤其是已有 Mypy/Pyright 配置的团队想提升速度
- 使用 Pydantic 或 Django 的项目，希望获得零配置的模型验证和字段类型支持
详细介绍
Pyrefly 是一款极速的 Python 类型检查器和语言服务器，经 Meta 内部 2000 万行 Instagram 代码库验证，每秒可检查超过 185 万行代码，速度是 Mypy 和 Pyright 的 15 倍。IDE 中保存文件后重新检查通常只需不到 10 毫秒。它提供完整的语言服务器功能（代码导航、自动补全、悬停信息、内联提示、语义高亮等），并原生支持 Pydantic 和 Django（模型验证、字段类型、自动补全开箱即用）。从 Mypy 或 Pyright 迁移只需 `pyrefly init` 初始化配置，`pyrefly suppress` 静默现有错误，`pyrefly infer` 自动生成类型注解。可通过 `pip install pyrefly` 安装命令行工具，也可安装 VS Code、Neovim、Zed 等编辑器扩展。
常见问题与排障 (1)
故障排除为什么 `pyrefly check --suppress-errors` 将内联忽略注释放在多行f字符串内部而不是上方？
这是 pyrefly 1.1.0 之前版本的一个已知 bug。修复位于 commit 170ea02a1a3a1a437437dd5753f2df0d7b82620e 中。请更新至 pyrefly 1.1.0 或更高版本，以获得将抑制注释放置在语句前一行的正确行为。
标签
快速上手
安装软件
根据你的发行版安装对应的包（dpkg / rpm / AppImage）
终端运行 pip install pyrefly 安装命令行工具
在项目目录执行 pyrefly init 生成配置文件（或直接运行 pyrefly 使用默认设置）
安装编辑器扩展：VS Code 搜索 Pyrefly 安装，或按官网配置 Neovim/Zed
- 终端运行 pip install pyrefly 安装命令行工具
- 在项目目录执行 pyrefly init 生成配置文件（或直接运行 pyrefly 使用默认设置）
- 安装编辑器扩展：VS Code 搜索 Pyrefly 安装，或按官网配置 Neovim/Zed
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
8b35318ba7377a621ff9d9ef77a443b6ad3cf065be566c84f5ae9c8318df5459该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
终端执行 pip uninstall pyrefly 卸载命令行工具；在 VS Code 扩展面板中禁用或卸载 Pyrefly 扩展。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ