使用pyenv+PDM环境时mypy为何报大量import-not-found错误？

核心原因 #

1. Mypy未关联到PDM使用的虚拟环境：全局安装的Mypy无法识别pyenv虚拟环境中PDM安装的依赖，导致找不到模块的实现或类型 stub。
2. 依赖的类型 stub 未被正确识别：部分依赖可能未自带类型定义，或Mypy未配置为自动查找这些 stub。

解决步骤 #

1. 在虚拟环境中安装Mypy作为开发依赖 #

避免使用全局Mypy，直接在项目虚拟环境内安装：

pdm add -d mypy

（-d 表示安装为开发依赖，仅在开发时使用）

2. 通过PDM运行Mypy #

使用PDM的run命令启动Mypy，确保它在项目的环境上下文内执行，自动识别所有依赖：

pdm run mypy .

3. 配置Mypy关联虚拟环境（可选但推荐） #

在项目根目录的pyproject.toml中添加Mypy配置，明确指定虚拟环境的Python解释器路径，确保Mypy能找到依赖：

[tool.mypy]
python_executable = "~/.pyenv/versions/myproject/bin/python"
strict = false  # 根据需求调整严格模式
show_error_codes = true

注意：替换路径为你实际的pyenv虚拟环境Python路径，可通过which python查看当前激活环境的Python路径。

4. 安装缺失的类型 stub（若仍有报错） #

对于部分未自带类型定义的依赖，安装对应的types-*包：

# 示例：安装pytest、orjson的类型 stub
pdm add -d types-pytest types-orjson

FastAPI、Pydantic、Psycopg等主流包通常已自带类型定义，无需额外安装。

5. 验证环境配置 #

运行以下命令确认PDM使用的是正确的虚拟环境：

pdm info

输出中的Python Interpreter路径应与pyenv虚拟环境路径一致。

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