Node.js TypeScript tsconfig配置问题：allowImportingTsExtensions报错

核心问题原因 #

allowImportingTsExtensions是TypeScript 5.0及以上版本才新增的编译器选项，你当前使用的typescript@4.9.4不支持该配置，导致添加后ts-node启动时抛出TS5023错误；而VSCode默认可能使用了更高版本的内置TypeScript语言服务，因此会要求开启该选项来支持.ts后缀的导入，形成版本不兼容的冲突。

解决方案 #

方案一：升级依赖到兼容版本 #

直接升级TypeScript和ts-node到支持allowImportingTsExtensions的版本：

1. 升级TypeScript到5.x+：

   npm install typescript@^5.0.0 --save-dev
   

2. 升级ts-node到11.x+（确保支持TS5）：

   npm install ts-node@^11.0.0 --save-dev
   

3. 在tsconfig.json中启用allowImportingTsExtensions：

   "compilerOptions": {
     "allowImportingTsExtensions": true,
     // 其他配置保持不变
   }
   

4. 重启服务器和VSCode，验证是否解决两边的报错。

方案二：不升级依赖，适配现有版本 #

如果不想升级依赖，可通过以下方式消除冲突：

1. 保持allowImportingTsExtensions关闭，修改VSCode使用的TypeScript版本为项目本地的4.9.4：
   • 点击VSCode右下角状态栏的TypeScript版本号（如显示5.x.x）
   • 在弹出的选项中选择Use Workspace Version，切换到项目本地安装的TS版本
   • 此时VSCode语言服务会和项目依赖版本一致，不再要求开启不支持的选项
2. （可选）统一导入风格：将所有带.ts后缀的导入语句去掉后缀，TS会自动解析对应文件，例如：
   • 原导入：import { foo } from './bar.ts'
   • 修改为：import { foo } from './bar'

额外注意事项 #

• 你的tsconfig.json中已开启noEmit: true，该配置与allowImportingTsExtensions兼容（该选项设计初衷就是用于不生成编译产物的场景，如开发时直接运行TS文件）
• 升级依赖后，若ts-node的ESM配置出现问题，可检查ts-node文档确认版本兼容的配置写法

内容的提问来源于stack exchange，提问作者any-1507