Svelte 5 生态系统中 AST 类型兼容性问题解析

在 Svelte 5 的升级过程中，生态系统中的一些工具包遇到了编译器抽象语法树(AST)类型兼容性问题。这个问题特别体现在 enhanced-img 这类依赖 Svelte 编译器类型的工具上。

问题本质

Svelte 5 对编译器内部实现进行了重构，特别是 AST 相关的类型定义。在旧版本中，TemplateNode 类型被定义在两个地方：

1. 在类型根目录下作为非导出类型
2. 通过 'svelte/types/compiler/interfaces' 导出

这种重复定义在 Svelte 5 中被清理，导致了依赖这些类型的生态工具出现类型检查失败。

解决方案分析

Svelte 核心团队提出了两种解决路径：

1. 临时兼容方案：继续暴露旧的 AST 类型，但这被认为不是理想的长期解决方案
2. 现代化迁移方案：推荐工具切换到 Svelte 5 引入的新版解析器输出

新版解析器可以通过设置 modern: true 标志来启用，它会返回结构更优的新版 AST。值得注意的是，Svelte 团队计划在未来的 Svelte 6 中完全移除旧版 AST 实现。

技术决策建议

对于生态工具开发者，建议采取以下升级策略：

1. 如果工具需要同时支持 Svelte 4 和 5，可以暂时在工具内部重新声明所需类型
2. 当确定工具仅支持 Svelte 5+时，应该：
   • 使用新版解析器输出
   • 迁移到新版 AST 类型定义
   • 将 peerDependency 设置为 Svelte 5 最低版本

版本演进思考

Svelte 团队在设计新版解析器标志时选择了 modern: true 而非 version: 5，这体现了他们对未来兼容性的考虑。这种设计意味着：

• 当前 modern 标志对应 Svelte 5 的 AST
• 未来如有重大变更，可以再次使用 modern 标志
• 旧版 AST 将被逐步淘汰

这种渐进式演进策略既保证了向后兼容，又为未来的架构改进留出了空间。