TypeScript语言服务器中模块导入路径扩展名的配置问题

问题背景

在使用typescript-language-server时，开发者经常遇到模块导入路径自动补全的问题。具体表现为当设置importModuleSpecifierEnding为"js"时，自动导入的路径不会自动添加.js扩展名，除非项目中的package.json文件包含"type": "module"声明。

问题现象

开发者提供了一个典型示例：

1. 存在一个导出模块testLib.ts，其中导出了TEST常量
2. 在另一个文件test.ts中使用TEST时触发自动导入
3. 期望生成的导入语句为import { TEST } from "./testLib.js"
4. 实际生成的导入语句却缺少扩展名：import { TEST } from "./testLib"

配置分析

开发者最初尝试的配置方式存在几个关键问题：

1. 配置位置错误：将相关配置放在了settings字段下，而实际上这些选项属于initializationOptions
2. 参数名称错误：使用了importModuleSpecifier，而正确的参数名应为importModuleSpecifierPreference

正确配置方式

正确的配置应该采用以下结构：

{
  "initializationOptions": {
    "preferences": {
      "importModuleSpecifierEnding": "js",
      "importModuleSpecifierPreference": "non-relative"
    }
  }
}

技术细节

1. 模块系统差异：TypeScript支持多种模块系统(CommonJS/ES Modules)，不同系统对文件扩展名的处理方式不同
2. ES Modules要求：当使用ES Modules时，文件扩展名通常是必需的
3. 自动导入行为：语言服务器会根据项目配置和文件类型决定是否添加扩展名

实际应用建议

1. 对于现代前端项目，建议在package.json中明确声明"type": "module"
2. 确保TypeScript配置(tsconfig.json)中的module选项与项目实际使用的模块系统一致
3. 在语言服务器配置中使用正确的参数名称和位置
4. 对于混合使用CommonJS和ES Modules的项目，需要特别注意路径处理的一致性

总结

正确配置TypeScript语言服务器的模块导入路径扩展名需要理解TypeScript的模块解析机制和服务器配置结构。通过使用正确的初始化参数和项目配置，可以确保自动导入功能生成符合预期的模块路径，提高开发效率和代码一致性。