SuperAPI AI 工具集

pyright-type-checker

编程与开发

查看项目

更新于 10-15 17:28

技能介绍

用途:Pyright 是微软开发的快速 Python 静态类型检查器,用于在编码和 CI 阶段发现类型错误,适合需要比 mypy 更快反馈、使用 VS Code(Pylance)、要求更严格类型检查或从 mypy 迁移的场景。

主要能力:支持 basic、standard、strict 三种类型检查模式,可逐文件用 # pyright: strict 等注释覆盖;具备类型收窄、TypeGuard、Protocol 结构化类型、TypedDict、Literal、泛型与变型、ParamSpec、类型别名等特性;支持 --watch 增量检查、--stats 统计类型完整度、--createstub 生成第三方包存根。

使用方式:安装可用 npm install -g pyright 或 npm install --save-dev pyright,也可 pip install pyright(仍需 Node.js 运行时);VS Code 可安装 Pylance 扩展。通过 pyrightconfig.json 配置 include、exclude、typeCheckingMode、pythonVersion、reportMissingImports 等项,命令行运行 pyright 或 pyright --level strict。可接入 GitHub Actions、pre-commit 与 Makefile。

适用场景:VS Code 用户、新项目、现代 Python(3.10+)、需要快速反馈或严格类型安全的团队。

限制:资料未提供官方定价与授权信息;pip 安装为社区封装且依赖 Node.js;与 mypy 在插件生态、配置粒度上存在差异,迁移需做配置与注释语法映射。性能对比数据来自资料示例,实际结果可能因项目而异。