跨文件调用函数时TypeScript类型推断失效问题求助

问题原因分析 #

你遇到的问题核心在于复合项目（Project References）的类型隔离配置：

• 负责编译业务代码的tsconfig.lib.json未配置生成类型声明文件（.d.ts），导致测试项目无法获取类型信息。
• tsconfig.node.json直接排除了所有业务代码文件，编译器仅能解析测试文件本身，无法关联getService方法的类型定义，最终将返回值推断为any。

具体解决方案 #

方案1：确保业务项目生成类型声明文件 #

修改tsconfig.lib.json，添加编译选项生成类型文件，让测试项目能读取到完整类型信息：

{
  "extends": "./tsconfig.json",
  "exclude": ["./src/**/*.test.ts", "./src/**/*.test.tsx"],
  "include": ["./src/**/*.ts", "./src/**/*.tsx"],
  "compilerOptions": {
    "declaration": true,          // 生成.d.ts类型声明文件
    "declarationMap": true,       // 生成类型映射文件，方便调试
    "outDir": "./dist",           // 指定输出目录，存放编译后的JS和类型文件
    "composite": true             // 复合项目必须开启此选项
  }
}

修改后先执行tsc -p tsconfig.lib.json编译业务代码，确保dist目录下生成对应的.d.ts文件，测试项目即可正确读取类型。

方案2：调整测试项目的文件匹配规则 #

若不想提前编译业务代码，可修改tsconfig.node.json，不再排除业务代码文件，让编译器直接解析源码类型：

{
  "extends": "./tsconfig.json",
  "include": ["./src/**/*.test.ts", "./src/**/*.test.tsx", "./src/**/*.ts", "./src/**/*.tsx"],
  "exclude": [],
  "compilerOptions": {
    "composite": true,
    "isolatedModules": false,
    "module": "ESNext",
    "moduleResolution": "Node",
    "allowSyntheticDefaultImports": true,
    "types": ["node", "jest"]
  }
}

该方式适合开发阶段，编译器会直接解析业务源码的类型，无需提前编译。

方案3：简化项目配置（无需复合项目时） #

若项目不需要拆分多个编译目标，可直接合并配置，删除tsconfig.json中的references，用单个配置文件覆盖所有代码：

{
  "extends": "../../tsconfig.json",
  "include": ["./src/**/*.ts", "./src/**/*.tsx"],
  "exclude": [],
  "compilerOptions": {
    "types": ["node", "jest"]
  }
}

这种方式彻底避免了复合项目的类型隔离问题，类型推断会自然恢复正常。

验证方法 #

修改配置后，重启TypeScript语言服务（VSCode可按Ctrl+Shift+P执行TypeScript: Restart TS Server），在测试文件中调用getService('myService')，此时应能正确推断出MyService的类型，调用方法时会出现代码提示。

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