Gradle压缩包允许同名文件？buildZip任务未覆盖文件问题咨询

我太懂这个坑了！Gradle的buildZip任务（底层基于Copy任务逻辑）默认并不会自动让后面from语句里的文件覆盖前面的同名文件，这确实会导致很多莫名其妙的问题——比如你以为打包的是dir2里的myFile.txt，结果解压出来却是dir1的，甚至有时候两个文件都被打包进去（取决于解压工具，可能会提示覆盖或者直接保留一个）。

问题根源 #

Gradle默认的duplicatesStrategy（重复文件策略）是INCLUDE，它会收集所有匹配的文件，当遇到同名文件时，不会主动替换，而是会保留所有实例（Zip包其实可以包含多个同名文件，只是解压的时候工具会处理，但这显然不是你想要的）。所以你的两个from...include语句会把两个myFile.txt都加入到打包队列里，最终结果就不符合预期了。

解决方案1：全局设置替换策略 #

最简单的办法就是在buildZip任务里直接设置重复文件策略为REPLACE，这样后面加入的同名文件会直接替换前面的：

task buildZip(type: Zip) {
    // 先加入第一个目录的文件
    from 'dir1'
    include 'myFile.txt'
    // 再加入第二个目录的文件
    from 'dir2'
    include 'myFile.txt'
    
    // 核心配置：遇到重复文件时用后面的替换前面的
    duplicatesStrategy = DuplicatesStrategy.REPLACE
}

这个策略是全局的，任务里所有重复的文件都会遵循这个规则。如果你需要不同的文件有不同的处理方式，可以看下面的精细控制方案。

解决方案2：针对特定文件设置覆盖策略 #

如果只需要让myFile.txt被覆盖，其他文件保持默认行为，可以用eachFile来单独配置：

task buildZip(type: Zip) {
    from 'dir1'
    include 'myFile.txt'
    from 'dir2'
    include 'myFile.txt'
    
    eachFile { fileDetails ->
        // 只对myFile.txt应用替换策略
        if (fileDetails.name == 'myFile.txt') {
            fileDetails.duplicatesStrategy = DuplicatesStrategy.REPLACE
        }
        // 其他文件保持默认策略
    }
}

额外说明 #

Gradle还提供了其他几种重复文件策略，你可以根据需求选择：

• DuplicatesStrategy.IGNORE：忽略后面的重复文件，保留第一个
• DuplicatesStrategy.FAIL：遇到重复文件直接抛出构建错误，适合严格的场景
• DuplicatesStrategy.INCLUDE：默认行为，保留所有重复文件

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