Typia项目中关于生成命令支持Glob模式的探讨

Typia作为一个强大的TypeScript验证库，提供了多种方式来生成类型验证代码。其中typia generate命令行工具是一个重要的功能，它允许开发者在不使用ts-patch和TypeScript转换器的情况下生成验证代码。

需求背景

在实际项目开发中，代码文件通常按照业务逻辑而非类型进行组织，这意味着验证器可能分散在项目的多个目录中。当前typia generate命令仅支持单一输入文件或目录，无法灵活处理这种分散的验证器文件结构。

解决方案探讨

社区成员提出了扩展typia generate命令以支持Glob模式的建议，主要包括两种实现思路：

1. 基于后缀的输出模式：允许用户指定一个后缀，生成的验证文件将与源文件位于同一目录，并添加指定后缀。例如：

   typia generate --input ./src/**/*.validator.ts --outputSuffix generated
   

2. 移除后缀的输出模式：允许用户移除源文件的后缀作为输出文件名。例如：

   typia generate --input ./src/**/*.validator.template.ts --outputRemoveSuffix
   

技术实现挑战

在尝试实现这一功能时，开发团队遇到了几个技术难点：

1. 根目录确定问题：当使用Glob模式匹配多个目录下的文件时，如何确定生成的根目录位置是一个挑战。初步设想是采用最公共的目录路径作为根目录。

2. 文件过滤问题：虽然可以通过Glob模式筛选输入文件，但由于TypeScript编译器会读取所有相关文件并构建完整的程序模型，难以精确控制哪些文件应该被包含在生成过程中。

替代方案建议

对于需要灵活文件组织结构的项目，开发团队推荐考虑使用unplugin-typia插件。该插件提供了更灵活的集成方式，尤其适合使用多种构建工具和环境的复杂项目。

结论

尽管Glob模式支持在理论上很有吸引力，但由于TypeScript编译器的工作机制限制，实现这一功能存在实质性困难。Typia团队在6.10.1-dev版本中进行了尝试，但发现无法有效控制生成范围。因此，目前建议开发者采用其他方式组织验证代码，或考虑使用插件方案来满足灵活性的需求。

对于需要严格分离构建工具和转换逻辑的项目，可以考虑通过脚本预处理文件列表，然后批量调用typia generate命令，这可能是当前最可行的折中方案。