JSON-Schema-to-TypeScript 项目优化：移除 glob 依赖的技术实践

在 Node.js 生态系统中，依赖管理一直是开发者需要面对的重要课题。json-schema-to-typescript 项目最近完成了一项重要的依赖优化工作，移除了 glob 依赖，显著减少了项目的依赖数量和安装体积。

背景与问题分析

json-schema-to-typescript 是一个将 JSON Schema 转换为 TypeScript 类型定义的工具库。在之前的版本中，它使用了 glob 模块来处理文件匹配，这带来了两个主要问题：

1. 依赖膨胀：glob 模块及其依赖项占据了整个项目 37 个依赖中的 26 个
2. 性能瓶颈：传统的 glob 实现在处理大量文件时性能表现不佳

解决方案评估

项目维护团队考虑了多种替代方案：

1. 组合方案：使用 fdir（高性能文件遍历）配合 picomatch（轻量级模式匹配）
2. 轻量级替代：采用 tinyglobby，这是一个基于 fdir 构建的更轻量的 glob 实现
3. 架构拆分：将 CLI 和核心功能分离到不同包中
4. 等待原生支持：等待 Node.js 22+ 的原生 glob 支持

经过深入讨论，团队最终选择了 tinyglobby 方案，主要基于以下考虑：

• 已经在多个知名项目（如 vitest、tsup、nuxt 等）中得到验证
• 基于 fdir 构建，性能优异
• 相比完整 glob 实现，显著减少了依赖数量
• 无需等待 Node.js 原生支持（预计要到 2026 年）

实施与效果

这一变更已经随 15.0.3 版本发布，带来了以下改进：

1. 依赖数量大幅减少：从 37 个依赖降至 11 个
2. 安装体积减小：减少了不必要的依赖下载
3. 性能提升：得益于 fdir 的高效实现，文件遍历速度更快

技术启示

这一优化案例为开发者提供了几个有价值的经验：

1. 定期审计依赖：即使是广泛使用的依赖项也可能成为优化点
2. 性能与体积权衡：在保持功能的同时，可以追求更优的实现
3. 渐进式改进：不必等待完美方案，可以先采用过渡性优化

对于类似工具库的开发者，这一案例也展示了如何在不影响用户体验的情况下，通过底层依赖优化来提升项目的整体质量。

未来，随着 Node.js 原生 glob 支持的成熟，项目可能会考虑进一步迁移，但目前的 tinyglobby 方案已经提供了一个优秀的中间解决方案。