要实现 VSCode 中 Python 代码的类型错误提示，需依次完成五步：一、用 pip install mypy 安装工具并验证；二、在 VSCode 扩展市场安装 Microsoft 官方 MyPy 插件；三、项目根目录建 mypy.ini 配置检查规则；四、在设置中指定 MyPy 可执行文件绝对路径；五、通过 settings.json 启用保存时自动检查。
如果您在 VSCode 中编写 Python 代码，但希望获得类似编译语言的类型错误提示与早期预警，则可能是由于 MyPy 静态类型检查未正确集成到编辑器工作流中。以下是实现该功能的具体配置步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 MyPy 命令行 工具
MyPy 插件依赖于本地已安装的 MyPy 可执行程序，必须先通过 Python 包管理器将其部署至系统路径中，否则插件无法调用类型检查引擎。
1、打开终端应用，确保已安装 pip 和 Python 3.9 或更高版本。
立即学习“Python 免费学习笔记（深入）”；
2、执行命令：pip install mypy。
3、验证安装是否成功：输入mypy –version，确认输出包含有效版本号（如“mypy 1.10.0”）。
二、启用 VSCode MyPy 扩展
VSCode 需通过官方扩展市场安装经认证的 MyPy 支持插件，该插件负责将编辑器操作与 MyPy CLI 调用桥接，并实时渲染类型错误标记。
1、在 VSCode 中按下Cmd+Shift+X（macOS）打开扩展面板。
2、搜索关键词 “MyPy”，找到由microsoft 发布的官方扩展（名称为“MyPy”且发布者为 Microsoft）。
3、点击“安装”，安装完成后重启 VSCode 窗口。
三、配置项目级 MyPy 参数
MyPy 默认行为可能不匹配项目实际结构，需通过 配置文件 声明源码根目录、忽略路径及类型严格性规则，确保检查范围精准且不误报。
1、在项目根目录下新建文件：mypy.ini。
2、写入以下基础内容：
[mypy]
files = src/**.py
disallow_untyped_defs = true
warn_return_any = true
四、设置 VSCode 工作区 MyPy 路径
当系统存在多个 Python 环境（如 venv、pyenv、conda）时，VSCode 可能无法自动定位正确的 MyPy 可执行位置，需显式指定其绝对路径以避免插件调用失败。
1、在 VSCode 中按下 Cmd+, 打开设置界面。
2、搜索关键词“mypy path”。
3、在“MyPy: Executable Path”设置项中填入完整路径，例如：/opt/homebrew/bin/mypy（macOS Homebrew 安装路径）或~/venv/bin/mypy（虚拟环境路径）。
五、启用保存时自动检查
手动触发类型检查效率较低，可通过 VSCode 的保存钩子机制，在每次文件写入磁盘后自动运行 MyPy，即时反馈类型问题。
1、打开项目根目录下的 .vscode/settings.json 文件（若不存在则新建）。
2、添加如下键值对：
“python.mypyEnabled”: true
“python.mypyArgs”: [“–show-column-numbers”]
“files.autoSave”: “onFocusChange”
