结论先行：要让 Jenkins 在代码提交后自动拉取、编译、测试并报告结果，必须完成三件事：

• 装对插件
• 写对流水线脚本
• 连通 Git 与 Jenkins 的触发链路

缺一不可，否则构建永远卡在“等推送”状态。

安装必需插件

一切从插件开始。

进入 Manage Jenkins → Plugins → Available plugins，搜索并勾选以下插件：

• Pipeline：流水线语法核心，没有它任务都没法选类型。
• Git：拉取代码的基础依赖。
• JUnit：解析测试报告并生成可视化结果。
• GitLab Plugin 或 GitHub Plugin：根据代码托管平台二选一，这是触发链路的入口。

插件装完了？必须重启 Jenkins，否则选择 Pipeline 类型时会报错“找不到 agent 定义”。

创建并配置流水线任务

新建任务

点击左侧 新建任务，输入任务名称（如 auto-test-pipeline），选择 流水线（Pipeline），然后点击确定。

编写流水线脚本

进入配置页，向下滚动到 Pipeline 区域。在 Definition 下拉框中选择 Pipeline script，然后粘贴下面这个最小可用脚本：

pipeline {
    agent any
    stages {
        stage('拉取') { steps { git 'https://your-git-repo-url.git' } }
        stage('测试') { steps { sh 'python -m pytest tests/ --junit-xml=report.xml' } }
        stage('报告') { steps { junit 'report.xml' } }
    }
}

注意：替换脚本中的 https://your-git-repo-url.git 为真实仓库地址。

如果仓库是私有的，需提前在 Credentials 中添加用户名密码或 SSH 密钥凭证，否则拉取时会报权限错误。

配置 Git 自动触发

设置 Jenkins 端触发器

进入任务配置页 → 构建触发器，根据代码平台勾选对应选项：

• GitHub：勾选 GitHub hook trigger for GITScm polling
• GitLab：勾选 GitLab webhook trigger

在 Git 平台新建 Webhook

前往你的 Git 平台项目设置，找到 Webhooks 并新建一个 webhook：

• URL：填入 Jenkins 任务页中刚勾选触发器后显示的完整回调地址（格式类似 http://jenkins-ip:8080/project/auto-test-pipeline/）。
• Secret token：GitLab 必填，GitHub 通常可不填。token 可在 Jenkins 任务配置页的“高级”选项中生成。
• 触发事件：勾选 Push events 和 Tag push events。
• 点击 Add webhook，然后测试能否正常发送。

最容易翻车的地方：Jenkins 地址对外不可达。Git 平台必须能通过公网或内网访问你填的 URL。绝对不能写 localhost 或 127.0.0.1，否则永远等不来触发信号。

验证自动构建是否生效

配置完成后，如何确认真的跑起来了？三种办法任选其一：

• 方法一：提交空变更。在 Git 仓库任意分支运行 git commit --allow-empty -m "trigger build" 然后 git push，观察 Jenkins 是否自动启动构建。
• 方法二：手动立即构建。在 Jenkins 任务页点击 立即构建，查看控制台输出是否完整执行“拉取→测试→报告”三个阶段。
• 方法三：测试 Webhook。回到 Git 平台的 Webhook 页面，点击 Test 按钮，然后查看 Jenkins 构建历史是否新增一条记录，且状态显示为 成功。

只要这三条链路都通了，后面每次代码推送，Jenkins 就会自动完成整套构建流程，省去手动触发的麻烦。