mypy 速查
共 24 条 mypy 类型检查用法，涵盖基础用法、配置、常用注解、忽略与逃生、集成。 支持搜索与分类筛选，点击即可复制。
基础用法
给动态语言加类型体检。
| 命令 | 说明 |
|---|---|
| 检查单个文件 | |
| 检查目录 | |
| 严格模式（最严） | |
| 忽略未装库的类型缺失 | |
| 安装检查所需的类型存根 |
配置
mypy.ini / pyproject.toml。
| 命令 | 说明 |
|---|---|
| 目标版本 | |
| 开启全部严格检查 | |
| 忽略缺失导入类型 | |
| 按模块覆盖 | |
| 指定配置文件 |
常用注解
写类型的基本写法。
| 命令 | 说明 |
|---|---|
| 函数参数与返回值 | |
| 容器类型（Python 3.9+ 内置泛型） | |
| 可选与联合类型 | |
| Any / 函数类型 | |
| 仅类型检查时导入（避免循环依赖） |
忽略与逃生
渐进式收紧。
| 命令 | 说明 |
|---|---|
| 忽略该行错误 | |
| 只忽略指定错误码 | |
| 显式断言类型 | |
| 让 mypy 输出推断出的类型（调试） | |
| 提示多余的忽略（清理用） |
集成
在编辑器与 CI 中使用。
| 命令 | 说明 |
|---|---|
| 以模块方式运行（避免 PATH 问题） | |
| 安装第三方库类型存根 | |
| 类型门禁 | |
| 编辑器实时提示 |
使用说明
mypy 速查：基础用法、配置、常用注解、忽略与逃生、集成；支持搜索与分类筛选，点击即可复制。
- 按用途点分类：基础用法、配置、常用注解、忽略与逃生、集成。
- 点「命令」列复制到终端或配置。
- 先在配置里开 mypy 基础检查，再逐步收紧到 strict。
- 逐步给公共函数加类型注解，收益最大。
常见问题
- 第三方库没有类型怎么办？
- 加 --ignore-missing-imports 或装 types-* 类型存根；也可在自己的 stub 文件里补声明。
- type: ignore 到处加好吗？
- 不好。它是逃生舱，应尽量少用并注明原因；开启 --warn-unused-ignores 可及时发现多余忽略。
- 需要联网吗？
- 不需要，本地可用。