虚拟环境可编辑模式安装包后VS Code不显示mypy错误怎么办？

问题重现 #

• 项目结构：根目录包含setup.py、包文件夹rise、虚拟环境venv，Shell和VS Code均配置使用该虚拟环境
• 正常状态：VS Code保存文件时，mypy自动运行并标记类型错误
• 异常触发：执行pip install -e .以可编辑模式安装rise包后，VS Code的mypy始终显示"Success: no issues found"，完全无法检测到类型错误；非可编辑模式pip install .无此问题，卸载可编辑包并重载VS Code窗口后功能恢复
• 关键矛盾：VS Code输出的mypy命令（如下），复制到终端执行能正常检测到错误，但VS Code内运行无结果

  ./venv/bin/python ~/.vscode/extensions/ms-python.python-2022.18.2/pythonFiles/linter.py -m mypy --show-column-numbers --strict ./rise/action.py
  

原因分析 #

可编辑模式安装时，Python会将项目包路径写入venv/lib/pythonX.X/site-packages/easy-install.pth，mypy在VS Code的运行环境中可能优先读取site-packages中注册的包路径，而非本地源码目录。此时若安装的可编辑包未包含完整类型信息，或mypy未正确识别本地源码的优先级，就会导致检查失效。

解决方案 #

1. 强制mypy检查本地源码（VS Code配置） #

在VS Code的settings.json中添加mypy参数，忽略site-packages中的包，强制检查本地源码：

"python.linting.mypyArgs": [
    "--strict",
    "--show-column-numbers",
    "--no-site-packages",
    "./rise"
]

2. 明确mypy检查范围（配置文件） #

在项目根目录创建mypy.ini（或pyproject.toml），指定检查模块和排除路径：

[mypy]
strict = True
show_column_numbers = True
exclude = venv/
modules = rise

此配置会让mypy明确聚焦本地rise模块，不受site-packages中可编辑安装的影响。

3. 确认VS Code解释器一致性 #

• 点击VS Code左下角状态栏的Python版本，选择项目内的./venv/bin/python（Windows为./venv/Scripts/python.exe）
• 重载VS Code窗口，确保解释器环境与终端完全一致

4. 清除mypy缓存 #

执行命令清除mypy缓存，避免旧缓存干扰：

mypy --clear-cache

之后重载VS Code窗口，重新触发类型检查。

验证 #

应用上述配置后，重新执行pip install -e .，修改rise/action.py引入类型错误（如返回None却声明返回bool），保存后查看VS Code是否正常标记错误。

内容的提问来源于stack exchange，提问作者Soren Bjornstad