SWC-Node在Windows环境下与tsconfig.json的交互问题解析

问题现象

在使用SWC-Node的@swc-node/register模块时，Windows系统用户可能会遇到一个特殊现象：当执行目录中存在tsconfig.json文件时，TypeScript代码无法被正确转译，导致类型注解被当作无效语法抛出错误；而移除该文件后，转译又能正常工作。

技术背景

SWC-Node是基于SWC(Rust编写的超快速TypeScript/JavaScript编译器)的Node.js绑定。@swc-node/register模块通过Node.js的loader机制实现即时转译(TypeScript→JavaScript)，类似于ts-node的功能。

问题复现条件

1. 环境要求：

   • Windows操作系统
   • Node.js 18.17或20.11版本
   • @swc-node/register 1.6或1.8版本

2. 文件结构：

   • test.ts文件包含简单的TypeScript代码(如带类型注解的const声明)
   • 同级目录存在tsconfig.json文件(即使是空文件)

3. 执行命令：

   node --loader @swc-node/register/esm test.ts
   

问题表现

当存在tsconfig.json时，SWC-Node未能正确处理TypeScript语法，导致类型注解被当作无效JavaScript语法。具体表现为：

• 抛出"Missing initializer in const declaration"语法错误
• 类型注解未被正确剥离

而当移除tsconfig.json后，转译过程恢复正常，TypeScript代码能够被正确执行。

问题根源

这个问题与SWC-Node在Windows环境下处理配置文件路径的方式有关。当检测到tsconfig.json存在时，SWC-Node会尝试加载并应用其配置，但在Windows路径处理上可能存在缺陷，导致转译流程异常。

临时解决方案

1. 将tsconfig.json移至子目录，从父目录执行命令
2. 暂时移除tsconfig.json文件
3. 使用更高版本的SWC-Node(该问题在后续版本中已修复)

技术启示

这个问题揭示了几个值得注意的技术点：

1. 构建工具对配置文件的敏感度：工具链对配置文件的检测可能影响整个转译流程
2. 跨平台兼容性：Windows和Unix-like系统在路径处理上的差异可能导致工具行为不一致
3. 模块加载顺序：Node.js的loader机制与配置文件加载的交互需要特别注意

对于开发者而言，当遇到类似转译问题时，检查配置文件的存在与否及其位置是一个有效的排查方向。