NestJS CLI v10 中隐藏资产文件未被复制的问题分析与解决方案

问题背景

在 NestJS CLI 从版本 9 升级到版本 10 的过程中，开发人员发现了一个关于资产文件复制的行为变化。具体表现为：当项目中的配置文件以点号(.)开头时（如 .development），这些文件在构建过程中不再被自动复制到 dist 目录中。

技术细节解析

这个问题的根源在于 NestJS CLI 内部使用的 glob 匹配模式。在 Node.js 生态系统中，glob 模式默认情况下不会匹配以点号开头的文件，这是 Unix/Linux 系统中隐藏文件的传统约定。NestJS CLI v9 可能对此做了特殊处理，而 v10 则遵循了更严格的 glob 规范。

影响范围

这个问题主要影响以下场景：

• 使用点号开头的配置文件（如 .env 类文件）
• 项目中包含需要被复制的隐藏文件
• 使用通配符模式 * 来匹配资产文件的情况

解决方案

目前有两种可行的解决方案：

1. 显式指定点号前缀： 在 nest-cli.json 配置文件中，修改 assets 配置项，明确包含点号前缀：

   "compilerOptions": {
     "assets": ["config/envs/.*"]
   }
   

2. 等待官方修复： 官方正在考虑添加一个新的配置属性来控制此行为，让开发者可以自主选择是否包含隐藏文件。

最佳实践建议

对于需要处理隐藏文件的 NestJS 项目，建议：

• 对于重要的配置文件，避免使用点号前缀命名
• 如果必须使用点号前缀，采用上述解决方案1的显式配置方式
• 保持对 NestJS CLI 更新的关注，及时应用官方修复

技术原理延伸

这个问题的本质是 glob 模式匹配的默认行为。在 Unix-like 系统中，以点号开头的文件被视为隐藏文件，许多工具（包括 glob 模式匹配）默认会忽略这些文件。NestJS CLI 在升级过程中可能调整了对 glob 库的使用方式，导致了这一行为变化。理解这一点有助于开发者更好地处理类似的文件匹配问题。