是的，在 Jenkins Pipeline 的 `script` 块中，**可以** 并且经常使用 `dir` 步骤。`dir` 步骤用于临时更改当前工作目录（Working Directory），其作用范围仅限于它包裹的代码块。这在需要进入特定子目录执行命令（如构建、测试、文件操作）时非常有用。 ### **`dir` 步骤的基本语法与行为** `dir` 步骤的语法如下： ```groovy dir('/path/to/target/directory') { // 在此代码块内执行的所有步骤，其当前工作目录都将临时更改为 '/path/to/target/directory' sh 'pwd' // 将输出 /path/to/target/directory // 其他步骤，如 readFile, writeFile, sh, bat 等 } // 在此代码块外，工作目录恢复为之前的状态 ``` 它的核心特性是 **作用域隔离**。在 `dir` 块内部执行的任何文件路径相关的操作，都将基于新的工作目录进行解析。 ### **在 `script` 块中使用 `dir` 的典型场景** 以下示例展示了如何在 `script` 块中结合 `dir` 步骤来组织构建流程。 #### **场景一：进入源码子目录进行构建** 假设你的项目是一个多模块 Maven 项目，构建某个特定子模块。 ```groovy pipeline { agent any stages { stage('Build Submodule') { steps { script { // 假设代码库根目录下有一个 'service-core' 子模块 dir('service-core') { echo "当前构建目录: ${pwd()}" // 输出 service-core 的绝对路径 // 在此目录下执行 Maven 构建 sh 'mvn clean package -DskipTests' // 构建产物将生成在 service-core/target/ 下 // 可以安全地使用相对路径操作该目录下的文件 def jarName = sh(script: "ls target/*.jar", returnStdout: true).trim() env.SUBMODULE_JAR = jarName } // 退出 dir 块后，工作目录回到 workspace 根目录 echo "返回根目录: ${pwd()}" // 仍然可以引用在 dir 块中设置的变量 echo "构建的JAR包是: ${env.SUBMODULE_JAR}" } } } } } ``` #### **场景二：在特定目录下执行脚本或处理文件** 你需要在一个由构建过程生成的临时目录或配置目录中运行脚本。 ```groovy stage('Run Tests in Report Dir') { steps { script { // 创建一个专门的测试报告目录 sh 'mkdir -p test-reports' dir('test-reports') { // 假设有一个测试脚本，它会在当前目录生成报告 sh './run-integration-tests.sh' // 此脚本在 test-reports 目录下执行 // 读取该目录下生成的报告文件 if (fileExists('test-results.xml')) { junit 'test-results.xml' // Jenkins JUnit 插件会从 test-reports/ 下查找文件 } // 归档此目录下的所有日志 archiveArtifacts artifacts: '*.log', allowEmptyArchive: true } // 工作目录已切换回原处，可以继续其他操作 } } } ``` ### **`dir` 与 `environment` 变量及路径的配合使用** 你可以在 `dir` 的路径参数中使用环境变量，这使得路径配置更加动态和灵活。 ```groovy pipeline { agent any environment { // 定义一个基础路径作为环境变量 BUILD_SUBDIR = 'applications/frontend' CUSTOM_WORKSPACE = "${WORKSPACE}/custom-build-area" } stages { stage('Complex Dir Usage') { steps { script { // 使用环境变量构建路径 dir(env.BUILD_SUBDIR) { echo "在子项目目录 ${pwd()} 中构建..." sh 'npm install && npm run build' } // 创建并使用一个自定义的绝对路径目录 sh "mkdir -p ${env.CUSTOM_WORKSPACE}" dir(env.CUSTOM_WORKSPACE) { echo "在自定义工作区 ${pwd()} 中处理构件..." // 将前面构建的产物复制过来 sh "cp ../${env.BUILD_SUBDIR}/dist/*.zip ." } // 嵌套使用 dir dir('parent') { sh 'echo "Inside parent" > parent.txt' dir('child') { sh 'echo "Inside child" > child.txt' // 此时 pwd() 将是 .../parent/child } // 这里 pwd() 是 .../parent sh 'cat parent.txt' } } } } } } ``` ### **重要注意事项与最佳实践** 1. **路径有效性**：在使用 `dir` 之前，最好确保目标目录存在，否则某些步骤可能会失败。可以使用 `fileExists` 或 `sh 'test -d'` 进行检查。 ```groovy script { if (!fileExists('target-directory')) { sh 'mkdir -p target-directory' } dir('target-directory') { // 安全操作 } } ``` 2. **作用域对变量和命令的影响**： * **环境变量 (`env.VAR`)**：其值不受 `dir` 影响，是全局的。 * **Shell 命令中的相对路径**：受 `dir` 影响。例如 `sh './script.sh'` 会在 `dir` 设定的目录中寻找 `script.sh`。 * **`pwd()` 函数**：返回 `dir` 块内的当前绝对路径。 * **`readFile` / `writeFile` 步骤**：如果使用相对路径，则相对于 `dir` 设定的目录。 3. **错误处理**：`dir` 块内的步骤失败，会正常导致 Pipeline 失败。可以将 `dir` 与 `try-catch` 结合进行更精细的控制。 ```groovy script { dir('critical-build') { try { sh 'make all' // 可能失败的命令 } catch (Exception e) { echo "构建失败，但继续执行清理: ${e.message}" // 执行一些清理操作 } finally { // 无论成功失败，都执行的清理步骤 sh 'make clean-temp' } } } ``` 4. **与 `ws` (workspace) 步骤的区别**： * `dir`：临时更改工作目录，是最常用、最轻量的目录切换方法。 * `ws`：为整个代码块指定一个**全新的工作空间根目录**，开销更大，通常用于需要在完全独立目录中执行任务或隔离环境的情况 [ref_4]。 ```groovy // 使用 ws 切换到另一个工作空间 ws('/opt/alternate/workspace') { checkout scm // 代码会克隆到 /opt/alternate/workspace dir('build') { // 相对于新的工作空间根目录 sh 'cmake ..' } } ``` 5. **性能考虑**：频繁切换目录 (`dir`) 本身开销很小。但要注意，如果 `dir` 块内执行了大量耗时的 Shell 命令，那么该块的整体执行时间就是这些命令的总和。合理的目录结构规划可以减少不必要的目录切换。 **总结**，`dir` 是 Jenkins Pipeline 中一个非常实用且强大的步骤，它允许你在 `script` 块（或任何 `steps` 块）内临时切换工作目录，从而以正确的路径上下文执行命令和文件操作。通过与环境变量、条件判断和错误处理结合，你可以构建出清晰、健壮且易于维护的目录感知型自动化流程。