Hatch项目模板中复合许可证表达式的使用限制解析

Hatch作为Python项目的现代化构建工具，提供了便捷的项目模板生成功能。在项目初始化时，开发者可以通过模板配置来指定项目的许可证类型。然而，当前版本在处理复合许可证表达式时存在一些需要注意的限制。

复合许可证表达式的问题

当开发者在模板配置中使用SPDX标准的复合许可证表达式时，例如"Apache-2.0 OR MIT"，Hatch并不会如预期那样生成包含多个许可证文件的LICENSES目录，而是仅创建一个空的LICENSE.txt文件。这与官方文档描述的行为不符。

同样地，生成的README.md文件中关于许可证的部分也存在问题。复合许可证表达式的Markdown链接无法正确生成，导致最终呈现的许可证链接无效。

正确的配置方式

经过验证，正确的做法是将复合许可证中的每个许可证作为数组的独立元素进行配置，而不是使用SPDX的复合表达式语法。例如：

[template.licenses]
headers = true
default = ["Apache-2.0", "MIT"]

这种配置方式能够确保Hatch正确生成包含多个许可证文件的目录结构，并在README中正确显示各个许可证的链接。

当前功能限制

目前Hatch对SPDX许可证表达式的支持存在以下限制：

1. 仅支持简单的OR逻辑表达式
2. 不支持AND逻辑表达式
3. 不支持WITH子句表示的许可证例外情况
4. 复合表达式中的链接生成功能不完善

这些限制意味着开发者在使用复杂许可证组合时需要特别注意，可能需要手动调整生成的文件内容。

最佳实践建议

对于需要使用复合许可证的项目，建议开发者：

1. 优先使用数组形式列出多个许可证
2. 生成项目后手动检查许可证相关文件
3. 必要时手动补充复合许可证的说明
4. 关注Hatch后续版本对许可证功能的改进

随着Hatch项目的持续发展，未来版本可能会增强对SPDX复合许可证表达式的完整支持，为开发者提供更灵活的许可证管理选项。