Groovy 中如何动态引用变量名对应的变量值?

在 groovy 中,若需根据字符串拼接出变量名并获取其值(如 `"${codebase}_sonar_binaries"`),不能直接用 `"${...}"` 插值访问局部变量;必须通过 `this."variablename"` 访问脚本级或对象属性级变量,或改用 map 统一管理变量。

上述问题的核心在于:Groovy 的字符串插值(GString)"${CODEBASE}_sonar_binaries" 仅做字面量替换,不会触发变量解析——它生成的是字符串 "dcihub_sonar_binaries",而非该变量所指向的值。要实现“动态变量名 → 变量值”的映射,需明确变量的作用域与访问方式。

✅ 正确做法:使用 this."${name}" 访问脚本级变量

Groovy 脚本顶层声明的变量(即不在任何 def 方法/闭包内定义的变量)会自动成为脚本对象(Script 实例)的属性,可通过 this."propertyName" 动态访问:

// ✅ 正确:脚本级变量(非局部),可被 this."xxx" 访问
dcihub_sonar_binaries = '$WORKSPACE/tenants/dcihub/ui.apps/target/,$WORKSPACE/tenants/dcihub/ui.config/target/,$WORKSPACE/tenants/dcihub/ui.content/target/'

def CODEBASE = "dcihub"
def SonarValues = [:]

if (CODEBASE == "platform") {
    SonarValues["platform"] = [platform_sonar_exclusion, platform_sonar_binaries]
} else {
    // 动态构造变量名,并通过 this 获取其值
    def varName = "${CODEBASE}_sonar_binaries"
    SonarValues[CODEBASE] = this."$varName"  // ← 关键:this."dcihub_sonar_binaries"
}

return SonarValues
⚠️ 注意:this."$varName" 仅对脚本作用域(script-level)变量有效。若变量定义在 def 方法、闭包或 run() 函数内部(如 Jenkins Pipeline 的 script{} 块中未显式提升作用域),则属于局部变量,无法通过 this 访问,此时会抛出 MissingPropertyException。

❌ 局部变量不可动态引用(常见陷阱)

以下写法无效,因为 hello_world 是局部变量,不属于 this 的属性:

def hello_world = "Hello world!"  // ← 局部变量,this 不可见
def suffix = "world"
println this."hello_${suffix}"  // ❌ MissingPropertyException: No such property: hello_world

✅ 更健壮、推荐的替代方案:统一使用 Map 管理配置

为避免作用域混乱和运行时异常,强烈建议将所有动态变量预存入 Map,再通过键访问:

def variables = [
    dcihub_sonar_binaries: '$WORKSPACE/tenants/dcihub/ui.apps/target/,$WORKSPACE/tenants/dcihub/ui.config/target/,$WORKSPACE/tenants/dcihub/ui.content/target/',
    platform_sonar_binaries: '/path/to/platform/binaries',
    // ... 其他变量
]

def CODEBASE = "dcihub"
def SonarValues = [:]

if (CODEBASE == "platform") {
    SonarValues["platform"] = [
        variables.platform_sonar_exclusion,
        variables.platform_sonar_binaries
    ]
} else {
    SonarValues[CODEBASE] = variables["${CODEBASE}_sonar_binaries"]
}

return SonarValues

✅ 优势:

  • 类型安全、IDE 可提示、无反射风险;
  • 明确数据契约,便于测试与维护;
  • 完全规避作用域问题,适用于 Jenkins Pipeline、Gradle、Spock 等任意 Groovy 上下文。

总结

场景 是否支持动态引用 推荐方式
脚本顶层变量(非 def 声明) ✅ this."name" 仅限简单脚本,慎用于复杂逻辑
局部变量(def x = ...) ❌ 不支持 改用 Map 或 @Field 提升作用域
配置类/参数化场景 ✅✅ 强烈推荐 Map 清晰、安全、可扩展

始终优先选择 显式 Map 映射,而非依赖 this. 反射访问——这既是 Groovy 最佳实践,也是构建可维护自动化流水线(如 Jenkinsfile)的关键原则。