Flit构建工具中Wheel包重复LICENSE文件问题解析

问题背景

在Python打包生态中，Flit作为一个轻量级的构建工具被广泛使用。近期发现Flit 3.11.0版本在构建Wheel包时会出现一个值得注意的问题：当项目配置中同时指定了license.file参数且该文件又被default_license_files_globs模式匹配到时，会导致生成的Wheel包中包含重复的LICENSE文件。

问题表现

具体表现为构建过程中会出现警告信息："Duplicate name: 'package_name-version.dist-info/licenses/LICENSE'"，使用unzip工具查看Wheel包内容时可以看到确实存在两个完全相同的LICENSE文件条目。这种重复会导致一些安装工具（如installer）在安装时抛出FileExistsError异常，影响正常安装流程。

技术分析

这个问题源于Flit的许可证文件处理逻辑。在3.11.0版本中，Flit会：

1. 根据pyproject.toml中显式指定的license.file添加许可证文件
2. 同时又会通过默认的许可证文件匹配模式(default_license_files_globs)自动包含匹配的文件

当这两个机制同时作用于同一个LICENSE文件时，就会产生重复。从技术实现角度看，这属于资源文件添加逻辑中的边界条件处理不完善。

影响范围

该问题主要影响：

1. 使用Flit 3.11.0及以上版本构建的项目
2. 项目配置中使用了license.file参数指定许可证文件
3. 指定的许可证文件名称与默认匹配模式相符（如常见的LICENSE文件）

解决方案

开发团队已经在后续提交中修复了这个问题。修复方案主要是优化了许可证文件的添加逻辑，确保不会重复添加相同的文件。对于遇到此问题的用户，可以：

1. 暂时降级到Flit 3.10.1版本
2. 等待包含修复的新版本发布
3. 临时修改许可证文件名使其不被默认模式匹配

最佳实践建议

为避免类似问题，建议开发者在配置项目时：

1. 明确选择一种许可证文件指定方式（显式指定或依赖自动发现）
2. 保持构建工具的及时更新
3. 构建后检查Wheel包内容是否包含预期文件
4. 在不同环境中测试安装流程

这个问题也提醒我们，在构建工具开发中需要特别注意文件资源的去重处理，确保构建产物的确定性。