unbuild项目中mkdist忽略源文件问题的分析与解决

问题背景

在构建工具unbuild的最新版本(v3.0.0及以上)中，用户报告了一个关于mkdist构建器无法正确处理源文件的问题。具体表现为当使用特定设置时，mkdist无法像预期那样处理src目录下的CSS文件，而这个问题在之前的候选版本(v3.0.0-rc.11)中却工作正常。

问题现象

用户设置如下：

entries: [
  'src/index',
  { 
    input: 'src', 
    outDir: '.', 
    pattern: ['**/*.css'], 
    builder: 'mkdist', 
    loaders: ['postcss'] 
  },
]

在v3.0.0-rc.11版本中，这个设置能够正常工作，CSS文件会被正确处理并输出到指定目录。但在v3.0.0及更高版本中，这个功能却失效了。

根本原因

经过项目维护者的调查，发现问题出在mkdist内部依赖的变更上。unbuild从v3.0.0开始，mkdist升级到了v2版本，而这一版本将文件匹配库从globby切换到了tinyglobby。

关键差异在于：

1. globby原生支持.gitignore文件的处理
2. tinyglobby则没有内置的.gitignore处理功能

这种底层依赖的变更导致了文件匹配行为的改变，进而影响了构建过程。

临时解决方案

在问题修复前，维护者提供了一个有效的临时解决方案：通过显式设置globOptions.ignore为空数组来绕过默认的忽略行为。

{
  input: 'src',
  outDir: '.',
  pattern: ['**/*.css'],
  builder: 'mkdist',
  loaders: ['postcss'],
  globOptions: { ignore: [] }
}

最终修复

该问题已在mkdist v2.2.0版本中得到彻底修复。用户可以通过升级相关依赖来解决问题：

pnpm upgrade unbuild mkdist

确保安装的是mkdist@2.2.0或更高版本即可。

技术启示

这个问题给我们提供了一个很好的案例，展示了底层依赖变更可能带来的兼容性问题。在构建工具链中，文件匹配是一个基础但关键的功能，任何这方面的变更都需要谨慎处理。同时，这也提醒我们：

1. 在升级主要版本时，需要关注底层依赖的变化
2. 文件匹配逻辑的变更可能会影响构建结果
3. 提供明确的设置选项可以帮助用户解决兼容性问题

对于开发者而言，当遇到类似构建工具行为变更时，可以首先检查版本差异和变更日志，这往往能快速定位问题原因。