ESLint 对 Node.js 新版 JSON 导入语法的支持现状

在 Node.js 生态系统中，JSON 文件的导入语法经历了多次演变。从 Node.js 14 开始，开发者可以使用 assert 关键字导入 JSON 文件，而在 Node.js 22 及更高版本中，这一语法被 with 关键字所取代。然而，许多开发者在使用这些现代 JavaScript 特性时遇到了 ESLint 的解析错误。

语法演变历程

Node.js 不同版本对 JSON 导入的支持方式有所不同：

1. 早期版本（Node.js < 14）： 通常需要通过 require() 或 fs.readFileSync() 等方式加载 JSON 文件

2. 过渡阶段（Node.js 14-21）： 支持使用 assert 关键字的模块导入语法：

   import data from './data.json' assert { type: 'json' };
   

3. 现代语法（Node.js ≥ 22）： 采用 with 关键字替代 assert：

   import data from './data.json' with { type: 'json' };
   

ESLint 的解析限制

目前 ESLint 的默认解析器（Espree）存在以下限制：

1. 对于 assert 语法会报告 "Unexpected token assert" 错误
2. 对于 with 语法会报告 "Unexpected token with" 错误

这些限制源于 ESLint 的保守策略——其默认解析器只支持已经完成标准化（ECMAScript Stage 4）的语法特性。

解决方案

对于需要使用这些现代语法的项目，开发者有以下几种选择：

1. 使用 Babel 解析器： 安装 @babel/eslint-parser 作为替代解析器，它可以解析实验性语法

2. 等待官方支持： ESLint 团队正在跟踪相关技术进展，一旦 Import Attributes 技术进入 Stage 4，官方将提供原生支持

3. 临时解决方案： 对于小型项目，可以考虑暂时禁用特定行的 ESLint 检查：

   // eslint-disable-next-line
   import data from './data.json' with { type: 'json' };
   

最佳实践建议

1. 对于新项目，建议直接使用 Babel 解析器配置
2. 对于已有项目，评估语法特性的必要性后再决定是否引入额外依赖
3. 关注 JavaScript 语言技术的进展，了解各特性的标准化状态

随着 JavaScript 生态系统的快速发展，开发者需要平衡对新特性的使用需求与工具的兼容性。理解这些底层机制有助于做出更明智的技术决策。