Jenkins不原生支持Pylint/Flake8，需用Shell脚本调用并配合Warnings Next Generation插件等方案；Violations插件仅兼容Pylint特定格式，且新版Jenkins存在路径、环境、编码等多重兼容问题。
直接说结论：Jenkins 本身不原生支持 Pylint/Flake8，必须靠 Shell 脚本 + Violations 插件（仅对 Pylint 有效）或直接解析标准输出（推荐），且 Flake8 不需要额外插件就能用。
为什么不能只装插件就完事
很多人搜“Jenkins pylint 插件”后装了 Violations，结果发现 Flake8 报告不显示、Pylint XML 解析失败、或者 pylint --output-format=parseable 输出被 Jenkins 当作构建失败。根本原因是：
- Violations 插件只认特定格式（如 Pylint 的
--output-format=parseable或--output-format=msvs），不支持 Flake8 原生输出； - 新版 Jenkins（2.400+）默认禁用脚本安全策略，
which pylint在 pipeline 中可能返回空，导致路径错误； - anaconda 环境下
pylint命令常因 Python 版本混用（如 py2/py3 混合环境）在 Jenkins agent 上找不到模块，报ModuleNotFoundError: No module named 'astroid'。
Shell 脚本中正确调用 pylint 和 flake8
不要依赖 which pylint，改用绝对路径或显式激活环境。推荐以下写法：
- 若用系统 Python：
python3 -m pylint --output-format=parseable --disable=C0114,C0115 your_package/ - 若用 virtualenv：
/var/lib/jenkins/venv/bin/python -m flake8 --max-line-length=88 --ignore=E203,W503 src/ - 若用 conda 环境：先
source /opt/conda/bin/activate myenv && python -m pylint ...，注意 Jenkins 默认 shell 是 sh，不是 bash，需显式指定#!/bin/bash头； - 关键：加
--exit-code（flake8）或--fail-under=8（pylint）来控制构建是否失败——否则即使有严重问题，Jenkins 也标为 SUCCESS。
让报告可视化：不用 Violations 插件也能看详情
Violations 插件已多年未更新，兼容性差，XML 解析容易崩。更稳的方式是：
立即学习“Python免费学习笔记（深入）”；
- 用
flake8 --format=pylint统一输出风格（与 pylint parseable 兼容），再配合Warnings Next Generation Plugin（推荐）； - 对 pylint，改用
--output-format=text+Console Output定位，配合正则高亮（Jenkins 内置 Console Output Regex Highlighter）； - 生成 HTML 报告并归档：
pylint --output-format=html --reports=y your_module.py > pylint-report.html，再用archiveArtifacts 'pylint-report.html'； - 避免写
pylint.xml：它不是标准 XML，很多解析器读不了，纯属误导。
Pipeline 脚本里怎么写才不翻车
声明式 Pipeline 示例（关键点已加注释）：
stage('Lint') {
steps {
script {
// 必须用 sh 而非 bat，Windows agent 也要配 WSL 或 Git Bash
sh '''
# 检查命令是否存在，不存在就退出构建（比静默失败好）
if ! command -v flake8 > /dev/null; then
echo "flake8 not found"; exit 1
fi
# 用 --exit-code=0 强制不失败，靠后续判断行数控制
flake8 --format=pylint src/ | tee flake8.out
# 若有警告，记录但不中断；若有 ERROR，才让构建失败
if grep -q "E[0-9]\{3\}" flake8.out; then
exit 1
fi
'''
}
}
}真正容易被忽略的是：Jenkins agent 的 locale 设置（如 LANG=C.UTF-8）缺失会导致 pylint 解析中文 docstring 报错；还有 pylint 默认检查 __init__.py 里的相对导入，而 CI 环境没设 PYTHONPATH 就会大量报 E0401 —— 这些细节不处理，报告里 80% 的错误都是假阳性。
