调用Jenkins函数时`param=value`语法的使用场景与疑问

问题背景 #

近期因混淆Groovy的两种函数调用语法，在Jenkins中遇到了意外问题。Groovy官方文档明确说明，func(param1: value1, param2: value2)和func(param1=value1, param2=value2)是两种不同的写法，并非等价。由于日常多用Python，错误假设后者和Python的命名参数逻辑一致，最终导致函数调用结果不符合预期。

两种语法的核心差异 #

• 命名参数（param: value）：这是Groovy原生的命名参数实现，本质是将所有参数打包成一个Map对象传递给函数。函数可以通过接收Map参数，或者定义与标签名匹配的参数来获取值，参数传递的顺序不影响最终结果，只要标签名正确即可。
• 标签式位置参数（param=value）：这种写法并非真正的命名参数，而是给位置参数添加了一个可读性标签。参数仍然严格按照函数定义的顺序传递，=后的标签仅作为注释说明，不参与参数匹配逻辑，等价于在位置参数旁标注含义的写法。

param=value语法的意义与优势 #

尽管容易和命名参数混淆，但该语法存在特定价值：

1. 提升代码可读性：当函数拥有多个同类型或含义相近的参数时，给位置参数添加标签，能直观体现每个参数的作用，比纯位置参数更清晰，减少因参数顺序记错引发的错误。
2. 兼容Java方法调用：Groovy调用Java方法时不支持param: value的命名参数写法，使用param=value的标签式写法，既能保留参数含义的可读性，又能符合Java方法对位置参数的要求。
3. 降低学习门槛：对于习惯Python等语言命名参数写法的开发者，该语法在视觉上更贴近已有习惯，帮助快速过渡到Groovy开发，同时明确区分了Groovy自身的Map式命名参数机制。

内容的提问来源于stack exchange，提问作者oats