SWC项目中使用`using`声明时缺少`_ts_add_disposable_resource`助手的解决方案

在使用SWC编译器处理TypeScript代码时，当代码中使用了using声明语法时，可能会遇到一个常见问题：编译器生成的代码中引用了@swc/helpers/_/_ts_add_disposable_resource模块，但在实际的@swc/helpers包中却找不到这个文件。

问题背景

using声明是TypeScript 5.2引入的一项新特性，它允许开发者声明一个在作用域结束时自动释放的资源。当SWC编译器处理包含using声明的代码时，会生成一些辅助函数来管理这些可释放资源。

在SWC 1.9.1版本和@swc/helpers 0.5.13版本中，编译器会生成对_ts_add_disposable_resource辅助函数的引用，但该函数并未包含在发布的helpers包中，导致构建过程失败。

技术细节

当代码中包含类似如下的using声明时：

class TempFile implements Disposable {
  #path: string;
  constructor(path: string) {
    this.#path = path;
  }
  
  [Symbol.dispose]() {
    console.log("Disposing of", this.#path);
  }
}

export function usingDeclaration() {
  using file = new TempFile(".some_temp_file");
  console.log("Got file", file);
}

SWC编译器会将其转换为使用辅助函数的代码，转换后的代码会尝试导入@swc/helpers/_/_ts_add_disposable_resource模块。

解决方案

这个问题已经在SWC项目的内部提交中得到修复。修复的核心是确保_ts_add_disposable_resource辅助函数被正确地包含在@swc/helpers包中。

对于遇到此问题的开发者，可以采取以下措施：

1. 升级到包含修复的SWC版本
2. 如果暂时无法升级，可以手动实现这个辅助函数

最佳实践

为了避免类似问题，建议开发者：

1. 保持SWC和其辅助包版本的同步更新
2. 在使用新TypeScript特性前，先确认SWC对其的支持程度
3. 关注SWC项目的更新日志，特别是关于新特性支持的说明

总结

using声明是管理资源生命周期的强大工具，但在使用SWC编译时需要确保辅助函数可用。通过了解这个问题及其解决方案，开发者可以更顺利地使用这一现代TypeScript特性。随着SWC项目的持续发展，这类兼容性问题将会越来越少。