Pylint 3.2.0 版本中忽略模式失效问题分析

Pylint 作为 Python 代码静态分析工具，在 3.2.0 版本中引入了一个关于文件忽略模式的重要回归问题。这个问题主要影响 .pyi 存根文件的处理方式，导致开发者配置的忽略模式失效。

问题现象

当项目中同时存在 .py 和 .pyi 文件时，Pylint 3.2.0 版本会错误地处理 .pyi 文件，即使开发者已经在配置中明确设置了忽略这些文件的模式。具体表现为：

1. 在 pyproject.toml 中配置的 ignore-patterns 对 .pyi 文件失效
2. Pylint 会错误地将 .pyi 文件当作普通 Python 文件解析
3. 导致报告不合理的错误，如将类型注解中的 | 操作符标记为无效语法

技术背景

.pyi 文件是 Python 的类型存根文件，用于提供类型提示信息。这些文件与常规 .py 文件有几个关键区别：

1. 语法上允许更灵活的类型注解表达
2. 函数体通常只包含 ... 省略号
3. 参数名可能仅用于类型提示而不实际使用

Pylint 原本应该完全忽略这些文件，或者至少以不同的方式处理它们。但在 3.2.0 版本中，当存在同名 .py 文件时，Pylint 会错误地尝试解析 .pyi 文件内容。

问题根源

经过分析，这个问题源于 astroid 3.2.0 中的一个改动。astroid 是 Pylint 使用的抽象语法树库，其修改了文件源获取逻辑，导致当 .py 和 .pyi 文件同时存在时，Pylint 会错误地处理 .pyi 文件。

影响范围

这个问题会影响以下情况的项目：

1. 使用 .pyi 文件提供类型提示
2. 项目中存在同名 .py 和 .pyi 文件
3. 使用 Pylint 3.2.0 版本进行代码检查

临时解决方案

开发者可以采取以下临时解决方案：

1. 降级到 Pylint 3.1.x 版本
2. 使用命令行参数直接指定忽略模式（非列表形式）
3. 在问题修复前，手动添加对特定错误的抑制

长期解决方案

Pylint 开发团队已经确认这是一个回归问题，并计划在后续版本中修复。修复方案可能包括：

1. 回滚 astroid 中的问题修改
2. 改进 .pyi 文件的处理逻辑
3. 确保忽略模式在所有情况下都能正确工作

最佳实践建议

对于需要同时使用 Pylint 和类型提示的项目，建议：

1. 保持 Pylint 版本更新，但注意检查变更日志
2. 为 .pyi 文件配置单独的检查规则或完全忽略
3. 在 CI 流程中加入对这类问题的监控
4. 考虑使用专门的类型检查工具（如 mypy）处理 .pyi 文件

这个问题提醒我们，在静态分析工具链中，各组件版本间的兼容性需要特别关注，特别是涉及语法解析的核心组件变更时。