在 Jenkins Pipeline (Groovy) 中，判断字符串是否包含特定字符，最常用的有三种方式：使用 contains() 方法、使用正则表达式 ~ 匹配符，或者使用 find()。

1. 使用 contains() 方法（最简单直接）

如果你只需要简单判断是否包含，可以直接调用字符串的 contains 方法。

def str = "项目名称：Jenkins"

if (str.contains("：") || str.contains("，")) {
    echo "检测到中文标点（冒号或逗号）"
}

2. 使用正则表达式（最推荐，代码简洁）

使用 Groovy 的正则匹配符 =~ (包含匹配)，可以用一个表达式同时检查多种字符。

def str = "姓名：张三"

// [：，] 表示匹配“中文冒号”或“中文逗号”中的任意一个
if (str =~ /[：，]/) {
    echo "字符串中包含中文冒号或中文逗号"
} else {
    echo "未检测到中文标点"
}

3. 在 Pipeline script 块中的完整逻辑示例

通常我们会在处理参数校验时用到这个逻辑：

pipeline {
    agent any
    stages {
        stage('Check Input') {
            steps {
                script {
                    def userInput = "tag1,tag2，tag3" // 模拟包含中文逗号的输入
                    
                    // 检查是否包含中文标点
                    if (userInput =~ /[：，]/) {
                        echo "警告: 检测到非标准标点（中文冒号或逗号）！"
                        
                        // 可以在这里直接进行替换标准化
                        def fixedInput = userInput.replaceAll(/，/, ",").replaceAll(/：/, ":")
                        echo "已自动修正为: ${fixedInput}"
                    } else {
                        echo "输入格式检查通过。"
                    }
                }
            }
        }
    }
}

方法对比与建议

小贴士：
在 Groovy 中，=~ 是“部分匹配”（只要包含就返回 true），而 ==~ 是“全量匹配”（字符串必须完全符合正则定义才返回 true）。因此，判断包含关系请务必使用 =~。

当contains 和正则都检测不到时

终极解决方案：使用 Unicode 码点进行替换

请尝试以下代码，这是在 Jenkins 环境下最稳妥的写法：

script {
    def str = "项目名称：Jenkins"
    
    // 使用 Unicode 码点进行正则匹配
    if (str =~ /[\uFF1A\uFF0C]/) {
        echo "检测成功：匹配到了中文冒号或逗号"
    }
}

script {
    def str = "项目A\uFF0C项目B\uFF1A内容" // 模拟包含中文逗号和冒号的字符串
    echo "原始字符串: ${str}"

    // 1. 必须将结果重新赋值给变量
    // 2. 使用 Unicode 码点 \uFF0C (，) 和 \uFF1A (：)
    // 3. 使用 replaceAll 配合正则表达式
    
    // 同时替换中文逗号和中文冒号
    str = str.replaceAll(/\uFF0C/, ",").replaceAll(/\uFF1A/, ":")

    echo "替换后字符串: ${str}"
}

Jenkins CPS 转换干扰

Jenkins Pipeline 的执行引擎（CPS）有时在处理复杂的字符串操作时会产生奇怪的行为。如果上面的赋值操作后依然无效，建议将逻辑包装在 @NonCPS 注解的方法中：

@NonCPS
def normalizeString(String input) {
    if (input == null) return null
    // 在 NonCPS 方法里，Groovy 回归原生性能，处理正则最可靠
    return input.replaceAll("\uFF0C", ",").replaceAll("\uFF1A", ":")
}

pipeline {
    agent any
    stages {
        stage('Fix String') {
            steps {
                script {
                    def rawData = "测试\uFF0C数据\uFF1A生效"
                    // 调用工具方法并接收返回值
                    def cleanData = normalizeString(rawData)
                    echo "清理后的结果: ${cleanData}"
                }
            }
        }
    }
}