Jenkins Pipeline 主要包含声明式（Declarative）与脚本式（Scripted）两种语法。声明式语法结构固定、官方推荐，适合绝大多数标准 CI/CD 场景；脚本式基于原生 Groovy，灵活度高，适合复杂逻辑定制。

快速处理思路

不需要执行 shell 命令，而是通过代码结构区分。声明式 Pipeline 必须以 pipeline 块包裹，脚本式 Pipeline 直接使用 node 块或 Groovy 脚本。

// 声明式写法示例
pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }
    }
}

// 脚本式写法示例
node {
    stage('Build') {
        sh 'mvn clean package'
    }
}

直接复制对应模板到 Jenkinsfile，根据项目复杂度选择结构。声明式代码层级固定，脚本式代码类似普通 Groovy 程序。

为什么会这样

两种语法的核心差异在于设计哲学不同。声明式 Pipeline 采用“约定大于配置”的理念，强制实施最佳实践，通过固定层级结构降低学习成本。脚本式 Pipeline 基于原生 Groovy 语言，本质是一段可执行程序，提供无约束的编程能力。

声明式语法在 Jenkins 2.0 引入，旨在解决脚本式语法门槛高、结构混乱的问题。官方文档明确推荐声明式作为标准语法，因为它支持语法预校验，能在保存阶段发现结构错误。脚本式语法属于早期实现，虽然灵活但缺乏结构验证，错误往往在运行时才暴露，增加排查难度。

分步处理

按照以下步骤选择并编写 Jenkinsfile：

步骤 1：评估流水线复杂度
如果流程是线性的构建、测试、部署，且逻辑固定，选择声明式。如果需要在流水线中执行复杂循环、动态生成阶段或条件判断，考虑脚本式。

步骤 2：编写基础结构
声明式必须顶层使用 pipeline 块，内部包含 agent、stages、steps 等固定指令。脚本式顶层使用 node 块，内部直接调用 stage 方法或编写 Groovy 逻辑。

步骤 3：配置执行代理
声明式必须在 agent 指令中指定执行节点（如 agent any）。脚本式在 node 块中隐式或显式指定节点，没有 agent 指令限制。

步骤 4：保存并校验
在 Jenkins 界面保存 Jenkinsfile 时，声明式语法会立即进行结构验证。脚本式语法通常直接保存，直到运行阶段才检查逻辑错误。

怎么验证是否生效

通过 Jenkins 界面状态和日志确认语法是否被正确识别。

检查点 1：语法校验提示
保存声明式 Jenkinsfile 时，如果结构错误，Jenkins 会直接提示语法验证失败。脚本式文件通常能保存，但运行时报错。

检查点 2：Stage View 视图
运行成功后，查看 Stage View 插件。声明式 Pipeline 会清晰展示 stages 和 stage 定义的层级结构。脚本式 Pipeline 也能展示阶段，但结构依赖于代码中的 stage 方法调用。

检查点 3：控制台日志
查看构建日志，确认步骤按预期执行。声明式日志通常更结构化，脚本式日志反映 Groovy 脚本执行流。

常见坑

声明式缺少 agent 指令
声明式 Pipeline 必须包含 agent 指令，否则流水线无效且无法分配工作区。脚本式没有此强制要求。

脚本式错误隐藏深
脚本式语法错误通常在运行时才暴露，导致构建中途失败。声明式能在保存阶段拦截大部分结构错误。

混合使用导致混乱
虽然声明式支持在 steps 中嵌入 script 块调用脚本式逻辑，但过度混合会增加维护成本。建议优先使用声明式原生指令，仅在必要时嵌套脚本块。

旧项目迁移成本
早期项目多使用脚本式，迁移到声明式需要重构代码结构。如果旧流水线运行稳定且逻辑复杂，不必强制迁移。

常见问题

声明式和脚本式能混用吗？

可以混用。声明式 Pipeline 允许在 steps 块中使用 script 指令嵌入脚本式代码，以处理复杂逻辑。

新手应该学哪种语法？

新手应优先学习声明式语法。官方推荐声明式，结构清晰且容错性高，能覆盖 90% 的常规 CI/CD 场景。

脚本式语法会被淘汰吗？

短期内不会淘汰。脚本式适用于高度定制化场景，官方仍支持该语法，但新特性优先支持声明式。

参考来源

• Jenkins Pipeline 语法全解：声明式与脚本式通俗对比实战教程
• Jenkins 声明式 vs 脚本式 Pipeline:我该选哪个？一个真实项目的选择指南-CSDN 博客
• Jenkins 声明式 vs 脚本式 Pipeline:我为什么最终选择了声明式？(附真实项目对比代码)
• 终极指南:Jenkins Pipeline 开发实战——声明式与脚本式流水线全面对比-CSDN 博客
• 使用 Jenkinsfile - Jenkins 官方文档
• jenkins pipeline 的声明式与脚本式 - 小家电维修 - 博客园