Mypy 的 exclude 选项仅过滤显式传入的路径列表，无法跳过 pytest 已自动发现并强制传递的文件；真正有效的做法是在 pytest 层级排除目录，而非依赖 mypy 配置。
mypy 的 `exclude` 选项仅过滤显式传入的路径列表，无法跳过 pytest 已自动发现并强制传递的文件；真正有效的做法是在 pytest 层级排除目录，而非依赖 mypy 配置。
在集成测试流程中（如使用 pytest-mypy 插件），mypy 的 exclude 配置（如 mypy.ini 中的 exclude=FolderNotIgnored/）并不会生效，原因在于：pytest 在执行前已扫描整个项目目录，将匹配的 .py 文件（包括 FolderNotIgnored/hello.py）作为测试项显式收集，并直接传递给 mypy 执行。而 Mypy 官方文档明确指出：“If files are passed explicitly on the command line, the exclude option is ignored.” —— 即一旦文件被显式传入，exclude 规则即被绕过。
因此，解决该问题的关键不在 mypy 配置，而在 阻止 pytest 发现并传递目标文件。以下是两种主流、可靠的实践方式：
✅ 方案一：命令行临时忽略（适用于调试或 CI 单次运行）
pytest --ignore FolderNotIgnored --mypy
⚠️ 注意：
--ignore后跟目录名（不带斜杠），且必须位于--mypy之前，确保 pytest 在收集阶段跳过该路径。
✅ 方案二：配置文件持久化忽略（推荐用于项目长期维护）
在 pyproject.toml 中添加：
[tool.pytest.ini_options] norecursedirs = ["FolderNotIgnored", "__pycache__", ".git"]
或在 pytest.ini 中：
[tool:pytest] norecursedirs = FolderNotIgnored __pycache__ .git
?
norecursedirs会令 pytest 完全不进入指定目录递归搜索，从根本上避免文件被收集。注意：不需加尾部/，也不支持通配符或正则。
❌ 常见误区澄清
-
mypy.ini中的exclude或files无法覆盖 pytest 的显式传参行为； -
--mypy-ignore是pytest-mypy插件的独立参数，作用于 mypy 报告级别（如忽略特定错误码），不控制文件是否参与检查； - 在
mypy命令行中手动指定--exclude FolderNotIgnored/有效，但pytest --mypy不会将该参数透传给底层 mypy 调用。
✅ 最佳实践建议
- 将需忽略的目录统一纳入
pytest的norecursedirs； - 若需更精细控制（如按文件名模式忽略），可配合
--ignore-glob（如pytest --ignore-glob="**/FolderNotIgnored/**"）； - 验证是否生效：运行
pytest --collect-only | findstr "hello.py"（Windows）或grep hello.py（Linux/macOS），确认目标文件未出现在收集列表中。
通过在测试框架层切断文件入口，才能真正实现“零干扰”的类型检查隔离。
