flake8更适合初建CI门禁：轻量快速、规则聚焦语法和基础风格；pylint适合已有规范的团队，需精细配置避免误报；二者不可混用。
pylint 和 flake8 哪个更适合做 CI 门禁
CI 流水线里设代码质量门，pylint 和 flake8 是最常被拉来对比的两个。别听别人说“都行”，实际差别很大：flake8 更轻、更快、规则更聚焦语法和基础风格；pylint 更重，能查变量作用域、未使用导入、类型一致性，但也更容易误报、更难调参。
实操建议：
-
flake8更适合初建门禁：启动快（尤其在大型项目中），规则少而稳，--max-line-length=88、--extend-ignore=E203,W503几个配置就能跑起来 -
pylint适合已有成熟规范的团队：必须配合.pylintrc关闭大量默认告警（比如too-few-public-methods），否则 PR 会被一堆无关警告卡住 - 二者不要混用——规则重叠多（比如
E722和W0702都是裸 except），CI 日志会混乱，排查成本翻倍
如何让 pylint 不因 type hint 报错
Python 3.9+ 项目加了 list[str] 这类新式泛型后，pylint 默认会报 invalid-name 或 not-callable，因为它还在用旧版 ast 解析器，对 PEP 585 支持不全。
关键不是升级 pylint，而是配对升级解析器：
立即学习“Python免费学习笔记（深入）”；
- 确保安装
pylint>=2.15.0+astroid>=2.12.0（老版本即使升级 pylint 也无效） - 在
.pylintrc中显式启用新解析器：ast-optimization=yes - 如果用
typing.List还没完全迁走，加disable=consider-alternative-union-syntax避免提示干扰
pre-commit hook 里怎么跳过某些文件校验
不是所有文件都要过质量门：生成的 protobuf 文件、第三方 vendor 包、临时脚本，硬塞进 pylint 或 flake8 只会拖慢 CI、制造噪音。
pre-commit 的跳过逻辑必须写在 .pre-commit-config.yaml 里，而不是靠工具自身 ignore：
- 用
files:正则精确匹配路径：files: ^src/.*\.py$，比exclude:更可靠 - 避免用
exclude: .*/migrations/.*这种模糊写法——pre-commit 的 exclude 是对整个 repo 根路径匹配，容易漏掉子模块 - 若需按内容跳过（比如某行含
# noqa: E501），那是 linter 自己的事；pre-commit 层面只管“是否传给它”，不管“它怎么处理”
CI 中超时或内存溢出怎么办
pylint 在单次扫描 500+ 文件时容易吃光内存或卡住，尤其在 GitHub Actions 的 2GB 内存限制下，错误现象通常是 Killed 或 Process finished with exit code 137。
这不是 bug，是设计使然——它要构建完整 AST 并跨文件分析。缓解只能靠拆解：
- 用
--jobs=2启动多进程（pylint支持，flake8不支持） - 把大目录拆成多个 job：比如
pylint src/api/、pylint src/core/分开跑 - 禁用重量级检查项：
--disable=duplicate-code,too-many-arguments,too-many-locals（这些最耗资源） - 绝对不要在 CI 中运行
pylint --recursive扫整个 repo——它会尝试解析venv/和.git/下的 Python 文件
复杂点在于：pylint 的性能瓶颈不在 CPU，而在内存分配模式；有些规则（比如 import-error）必须加载全部依赖才能判断，这时候跳过比优化更实际。
