TypeScript-ESLint 项目中模块与命名空间AST一致性修复

在TypeScript-ESLint项目中，开发团队最近发现并修复了一个关于AST(抽象语法树)结构的重要问题。这个问题涉及到TypeScript中两种语法形式——module和namespace声明——在AST表示上的不一致性。

问题背景

TypeScript支持两种语法来声明命名空间：namespace X.Y {}和module X.Y {}。从语义上讲，这两种形式是完全等价的，只是关键字不同。然而，在TypeScript-ESLint的AST解析中，这两种形式却产生了不同的AST结构。

对于namespace X.Y {}，AST被正确解析为一个TSModuleDeclaration节点，其name属性是一个TSQualifiedName("X.Y")。而module X.Y {}则被错误地解析为嵌套的TSModuleDeclaration节点，其中外层节点名为"X"，内层节点名为"Y"。

技术影响

这种不一致性会对开发者编写ESLint规则带来困扰。由于两种语法形式在语义上等价，开发者通常会期望对它们应用相同的规则逻辑。然而，由于AST结构不同，开发者不得不编写额外的代码来处理这两种情况。

更重要的是，这种不一致性也影响了与其他工具(如Babel)的互操作性。Babel团队在尝试与TypeScript-ESLint的AST对齐时，发现这个问题只是"移动"了差异，而非真正解决了差异。

解决方案

TypeScript-ESLint团队确认这是一个需要修复的bug。修复方案是将module X.Y {}的AST结构改为与namespace X.Y {}一致，即使用TSQualifiedName表示限定名称，而不是嵌套的模块声明。

虽然这个改动在技术上是一个破坏性变更(breaking change)，但考虑到：

1. 这是一个明显的bug修复
2. 受影响的是较少使用的AST部分
3. Babel等重要工具需要这个修复

团队决定在当前版本中实施这个修复，而不是等到下一个主版本更新。

对开发者的建议

对于使用TypeScript-ESLint的开发者，特别是那些编写自定义ESLint规则的开发者，需要注意：

1. 现在可以统一处理module和namespace声明的AST结构
2. 不再需要为两种语法形式编写不同的处理逻辑
3. 如果之前有代码专门处理嵌套模块声明的情况，可能需要更新

这个修复体现了TypeScript-ESLint团队对AST一致性和工具互操作性的重视，也展示了开源项目中不同工具团队之间的良好协作。