TypeScript编译API预发射诊断报'Cannot find name 'Array''错误求助

你的问题核心是自定义编译主机没有正确加载TypeScript的内置标准库，同时未应用tsconfig中的编译配置，导致全局类型和工具类型无法被识别。下面是具体的修复步骤：

问题根源 #

1. 内置库加载失败：自定义主机的getDefaultLibFileName直接返回lib.d.ts，但TypeScript无法定位到实际的库文件路径，导致Array、Exclude等内置/工具类型找不到。
2. 文件读取逻辑错误：readFile总是返回空字符串，fileExists总是返回true，无法正确读取依赖的源文件和库文件。
3. 未应用tsconfig配置：创建ts.createProgram时传入了空的编译选项对象，导致tsconfig里的lib等关键配置没生效。
4. 路径处理错误：getCurrentDirectory返回空字符串，破坏了模块解析和文件路径的正常处理。

修复方案 #

1. 正确加载tsconfig配置 #

不要手动传空编译选项，而是读取并解析你的tsconfig文件，把配置应用到程序创建中。

2. 修复自定义编译主机的关键方法 #

• 委托默认主机处理大部分文件操作，只针对目标文件做自定义处理；
• 确保getDefaultLibFileName能返回正确的库文件路径；
• 正确实现readFile、fileExists、getCurrentDirectory等方法。

3. 正确获取诊断信息 #

注意区分program.getPreEmitDiagnostics()和emitResult.diagnostics，前者包含类型检查、库加载等所有预发射错误，后者只包含发射阶段的错误。

修改后的完整代码 #

import ts from 'typescript';
import { readFileSync, existsSync } from 'fs';
import { resolve } from 'path';

// 读取并解析tsconfig
const tsconfigPath = resolve('./tsconfig.json');
const tsconfigContent = readFileSync(tsconfigPath, 'utf8');
const tsconfigJson = ts.parseJsonConfigFileContent(
  JSON.parse(tsconfigContent),
  ts.sys,
  process.cwd()
);

// 创建默认编译主机
const defaultCompilerHost = ts.createCompilerHost(tsconfigJson.options);

// 自定义编译主机：只拦截目标文件的读取，其余委托默认主机
const createCustomCompilerHost = (targetFilename: string, targetSourceFile: ts.SourceFile) => {
  return {
    ...defaultCompilerHost,
    getSourceFile: (name, languageVersion) => {
      if (name === targetFilename) {
        return targetSourceFile;
      }
      // 其余文件交给默认主机处理
      return defaultCompilerHost.getSourceFile(name, languageVersion);
    },
    // 覆盖writeFile，避免实际生成文件
    writeFile: (filename, data) => {},
  };
};

// 目标文件处理
const filename = resolve('./file.ts');
const content = readFileSync(filename, { encoding: 'utf8' });
const sourceFile = ts.createSourceFile(filename, content, ts.ScriptTarget.Latest);

// 创建程序：传入tsconfig的选项和文件列表
const program = ts.createProgram(
  [filename, ...tsconfigJson.fileNames], // 包含tsconfig中指定的所有文件
  tsconfigJson.options,
  createCustomCompilerHost(filename, sourceFile)
);

// 获取预发射诊断
const preEmitDiagnostics = program.getPreEmitDiagnostics();
if (preEmitDiagnostics.length > 0) {
  console.log('预发射诊断错误：');
  console.log(ts.formatDiagnosticsWithColorAndContext(preEmitDiagnostics, {
    getCurrentDirectory: () => process.cwd(),
    getNewLine: () => '\n',
    getCanonicalFileName: (f) => f
  }));
}

const emitResult = program.emit();
const checker = program.getTypeChecker();

关键修改说明 #

• 加载tsconfig：通过ts.parseJsonConfigFileContent解析tsconfig，确保lib等编译选项被正确应用；
• 委托默认主机：自定义主机只替换需要修改的方法（getSourceFile、writeFile），其余方法复用默认主机的实现，保证文件读取、库加载等逻辑正常；
• 正确路径处理：使用resolve处理文件路径，getCurrentDirectory复用默认主机的实现（或直接返回process.cwd()），确保模块解析和文件定位正确；
• 包含所有依赖文件：创建程序时传入tsconfig中的fileNames，确保所有依赖的源文件和库文件都被加载。

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