Metro v0.82.0 发布：全面支持 package.json exports 与性能优化

项目简介

Metro 是 Facebook 开发的一款高效的 JavaScript 打包工具，专门为 React Native 应用设计。它以快速构建和热重载能力著称，能够高效处理 JavaScript 模块的依赖关系，是现代 React Native 开发中不可或缺的工具链组成部分。

核心更新解析

1. package.json exports 支持成为默认行为

本次更新的重大特性是默认启用了对 package.json#exports 字段的解析支持。这个 Node.js 12+ 引入的特性允许包作者：

• 精确控制包的入口点
• 为不同环境（如浏览器、Node.js）提供不同的实现
• 隐藏内部模块结构
• 实现条件导出

对于 React Native 开发者而言，这意味着 Metro 现在能够更好地与现代 npm 生态系统兼容，特别是那些已经开始使用 exports 字段来组织代码的流行库（如 React 本身）。

2. 破坏性变更与 API 调整

2.1 Transformer 接口变更

集成 metro/src/DeltaBundler/Transformer 的开发者需要注意，现在必须传递包含 getOrComputeSha1 方法的选项对象。这个变更反映了 Metro 内部对文件哈希计算方式的优化。

2.2 废弃 getSha1 方法

metro/src/node-haste/DependencyGraph.getSha1 已被移除，开发者应迁移至新的 getOrComputeSha1 接口。这个变更与下面的性能优化密切相关。

3. 性能优化：懒哈希计算

v0.82.0 默认启用了懒文件哈希计算机制，这是通过新的 watcher.unstable_lazySha1: true 配置实现的（可通过设为 false 禁用）。这项优化带来的好处包括：

• 构建速度提升：只在需要时计算文件哈希，减少不必要的 I/O 操作
• 内存占用优化：避免预计算和缓存所有文件的哈希值
• 增量构建优化：特别适合开发时的热重载场景

技术影响分析

对 React Native 开发者的影响

1. 更好的包兼容性：许多现代 JavaScript 库开始采用 exports 字段，这次更新确保了 React Native 项目能够正确解析这些包的结构。

2. 开发体验提升：懒哈希计算可以显著减少开发服务器的启动时间，特别是在大型项目中使用热重载时。

3. 迁移注意事项：

   • 如果项目自定义了 Metro 配置或扩展了 Transformer，需要按照新 API 进行调整
   • 极少数情况下，如果遇到哈希相关的问题，可以暂时关闭懒哈希计算进行排查

对库开发者的启示

1. exports 字段的使用：现在可以安全地在 React Native 相关的库中使用 package.json#exports 来组织代码结构。

2. 性能优化模式：Metro 的懒计算策略值得借鉴，特别是对于需要处理大量文件的构建工具。

升级建议

1. 测试先行：由于包含破坏性变更，建议在测试环境中先验证项目构建是否正常。

2. 性能对比：可以在升级前后分别记录构建时间，特别是开发服务器的启动时间，以验证懒哈希计算的实际效果。

3. 问题排查：如果遇到模块解析问题，检查是否是 exports 字段的兼容性问题；如果遇到哈希相关问题，尝试关闭懒哈希计算。

总结

Metro v0.82.0 通过支持现代 JavaScript 模块标准和引入创新的懒哈希计算机制，进一步巩固了其作为 React Native 首选打包工具的地位。这些改进不仅提升了开发体验，也为未来功能奠定了基础。开发者可以期待更快的构建速度和更好的生态系统兼容性，同时需要注意相关的 API 变更以适应新版本。