@hey-api/openapi-ts 项目中.js扩展名自动添加问题解析

在TypeScript项目中使用@hey-api/openapi-ts工具生成API客户端代码时，开发者可能会遇到一个常见问题：生成的导入语句会自动添加.js扩展名。这个问题在0.67.x版本中首次出现，而在之前的0.66.7版本中则不存在。

这个现象实际上与TypeScript的模块解析策略密切相关。当项目配置为使用NodeNext模块系统时，TypeScript会强制要求显式指定文件扩展名，这是ES模块规范的要求。@hey-api/openapi-ts工具会读取项目的tsconfig.json配置，并根据其中的module设置来决定是否添加.js扩展名。

对于使用monorepo结构的项目，这个问题可能更加明显。因为工具可能会错误地读取根目录下的tsconfig.json配置，而不是当前项目的配置。解决方案是指定正确的tsconfig路径，或者调整模块系统配置。

从技术实现角度来看，这个"问题"实际上是工具遵循TypeScript最新规范的表现。在Node.js的ES模块系统中，显式指定文件扩展名是必要的，这有助于消除模块解析的歧义，提高代码的明确性。

对于不希望添加.js扩展名的项目，开发者可以考虑以下几种解决方案：

1. 检查并确认项目的tsconfig.json配置
2. 显式指定工具使用的tsconfig路径
3. 根据项目需求调整模块系统设置

理解这一机制有助于开发者更好地使用@hey-api/openapi-ts工具，也能加深对TypeScript模块系统的认识。随着TypeScript和Node.js生态的发展，遵循ES模块规范将成为趋势，这类显式扩展名的要求可能会变得更加普遍。