TypeScript是否应转译JSON导入中的具名导入属性？

现状问题 #

TypeScript 5.3引入了对import attributes的支持，在ESM项目中，编译器允许开发者使用如下具名导入JSON的语法：

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

但当前JavaScript运行时（包括Node.js 22、Chrome 127）均不支持该写法，执行时会直接报错；而改用默认导入后则可正常运行：

import tsconfig from './tsconfig.json' with {type: 'json'};
const { compilerOptions } = tsconfig;

两种方案的利弊分析 #

方案1：对具名导入进行转译 #

• 优势：兼容开发者的习惯写法，无需修改代码即可在运行时正常工作，降低迁移成本。
• 劣势：
  • 需要在编译阶段做额外静态分析，将具名导入转换为默认导入加解构的形式，增加编译器复杂度。
  • 若JSON文件结构出现动态变化（虽JSON通常为静态文件），解构可能出现预期外错误，与TS类型检查逻辑产生偏差。
  • 转译后的代码与TS源码的语法语义并非完全等价，可能引发理解混淆。

方案2：直接禁用该语法 #

• 优势：
  • 贴合当前JavaScript运行时的实际支持情况，从根源避免运行时错误，保证代码可执行性。
  • 简化编译器逻辑，无需额外处理转译逻辑，符合"不引入超出运行时支持的语法糖"的设计原则。
• 劣势：限制了开发者的写法灵活性，需要手动改为默认导入加解构的形式，增加少量代码量。

结论 #

从当前运行时的支持现状和TS的设计定位来看，优先选择禁用该语法并给出清晰的编译错误提示会更合理。理由如下：

1. TS的核心目标之一是保证编译后的代码能在目标环境正常运行，禁用不被运行时支持的语法能避免开发者踩坑。
2. 若后续JavaScript运行时原生支持了JSON具名导入，TS再放开该语法即可，无需提前做兼容转译。
3. 即使开发者有使用具名导入的需求，手动改为默认导入加解构的成本极低，且代码语义更清晰。

内容的提问来源于stack exchange，提问作者MDMower