TypeScript Compiler API类型检查器与VS Code语言服务类型不一致问题

核心问题：程序初始化不完整 #

你当前创建Program时只传入了单个目标文件，并且手动指定编译选项，这和VS Code内部的类型检查逻辑完全不同——VS Code是基于整个项目的tsconfig.json加载所有相关文件，并复用项目完整配置做类型推导的。仅加载单个文件会丢失上下文依赖（比如解构数组的原始类型定义、全局lib和项目配置），导致TypeChecker无法正确推导复杂类型，出现any/{}这类错误结果。

具体修复步骤 #

1. 基于项目tsconfig创建Program #

不要手动硬编码编译选项，而是加载项目的tsconfig.json初始化Program，确保和IDE使用完全一致的配置：

// 替换原program初始化代码
const tsconfigPath = ts.findConfigFile(
  process.cwd(),
  ts.sys.fileExists,
  "tsconfig.json"
);
if (!tsconfigPath) {
  throw new Error("找不到tsconfig.json");
}

const configFile = ts.readConfigFile(tsconfigPath, ts.sys.readFile);
const parsedConfig = ts.parseJsonConfigFileContent(
  configFile.config,
  ts.sys,
  path.dirname(tsconfigPath)
);

const program = ts.createProgram({
  rootNames: parsedConfig.fileNames, // 加载项目所有文件
  options: parsedConfig.options, // 使用tsconfig的编译选项
});

2. 确保目标文件在项目上下文内 #

如果仅需处理单个文件，也要确保它被包含在tsconfig的include范围内，或手动添加到rootNames中，但必须保留完整的项目配置，让TypeChecker能获取必要的上下文依赖。

3. 优化类型获取逻辑 #

获取类型时优先通过Symbol再取类型，同时正确设置typeToString参数：

// 替换原类型获取代码
const symbol = checker.getSymbolAtLocation(node);
if (!symbol) {
  // 处理无符号的情况
  return;
}
const type = checker.getTypeOfSymbolAtLocation(symbol, node);
// 使用默认格式标志，或按需指定
const typeAsString = checker.typeToString(type, node);

4. 对齐TypeScript版本 #

确保你的扩展中安装的TypeScript版本和目标项目的TS版本完全一致（不要用^模糊版本），版本不匹配会导致类型检查逻辑出现差异。

关键说明 #

• TypeScript的类型推导严重依赖完整的项目上下文，单个文件孤立编译时，解构、Promise、箭头函数上下文类型等复杂场景无法被正确解析。
• VS Code的悬浮类型是基于项目级Program计算的，你的代码必须对齐这个逻辑才能得到一致结果。

内容的提问来源于stack exchange，提问作者Johannes