Gradle Task的commandLine中使用||运算符实现npm包按需安装的问题

你原来的Gradle任务写法失效的核心原因是：Gradle的Exec任务默认会直接调用npm命令，把||当成npm list的参数传递，而非让系统shell解析这个逻辑或运算符。最终实际执行的是npm list -g package || npm install -g package，npm会把||、npm这些内容都当作要查询的包名，自然只会执行list操作，还会报错找不到这些不存在的包。

方案1：通过系统shell执行完整命令 #

让Gradle调用对应系统的shell（Windows用cmd，Linux/macOS用sh），把带||的完整命令作为参数传给shell，由shell解析逻辑运算符：

import org.gradle.internal.os.OperatingSystem

task installPackage(type: Exec) {
    if (OperatingSystem.current().isWindows()) {
        commandLine 'cmd', '/c', 'npm list -g package || npm install -g package'
    } else {
        commandLine 'sh', '-c', 'npm list -g package || npm install -g package'
    }
}

方案2：Gradle原生逻辑判断 #

手动执行npm list并检查退出码，根据结果决定是否执行npm install，这种方式不依赖shell，更贴合Gradle任务的编写逻辑：

task installPackage {
    doLast {
        // 执行npm list，忽略退出码避免任务直接失败
        def listResult = exec {
            commandLine 'npm', 'list', '-g', 'package'
            ignoreExitValue = true
        }
        // 退出码非0表示包未安装，执行安装操作
        if (listResult.exitValue != 0) {
            exec {
                commandLine 'npm', 'install', '-g', 'package'
            }
        }
    }
}

这种方式的优势是逻辑清晰，还能灵活扩展（比如过滤npm list的输出，避免因版本不匹配导致的误判）。

方案3：直接执行npm install #

npm install -g package本身会自动检查包是否已安装：如果包存在且是最新版本，npm只会输出up to date，不会重复下载安装。若可以接受这种“冗余执行”，直接写最简任务即可：

task installPackage(type: Exec) {
    commandLine 'npm', 'install', '-g', 'package'
}

这种方案最简单，适合对执行效率要求不高的场景。

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