VSCode中TypeScript项目未提示缺失导入错误如何解决

问题根因 #

你的两个TS文件均无import/export声明，TypeScript默认将这类文件判定为全局脚本，所有顶层声明都会被纳入全局作用域，因此编译器会认为function_1全局可访问，不会触发导入缺失报错。但实际编译为CommonJS模块后，每个文件的顶层作用域相互独立，未导出、未导入的函数自然会在运行时抛出function_1 is not defined错误。
你单独编译file-2.ts时触发报错，是因为单文件编译场景下编译器不会加载全局作用域下其他文件的声明，因此可以正确识别函数未定义。编译报错仍生成JS文件是TypeScript的默认行为，可通过配置关闭。

解决方案 #

1. 调整TS配置强制模块校验 #

在tsconfig.json的compilerOptions中新增如下配置：

{
  "compilerOptions": {
    // 原有配置保持不变，新增以下3项
    "moduleDetection": "force",
    "isolatedModules": true,
    "noEmitOnError": true
  }
}

• moduleDetection: "force"：强制将所有TS文件视为ES模块，无论是否存在import/export声明，此时未导入的外部函数会直接触发编译报错。
• isolatedModules: true：要求每个文件可被单独编译，进一步强制模块规范，避免全局脚本的异常行为。
• noEmitOnError: true：编译报错时终止输出JS文件，符合常规开发校验预期。

2. 代码遵循ES模块规范 #

主动在业务代码中添加导出、导入语句，遵循模块化开发规则：

• file-1.ts添加导出声明：

export function function_1() {
    console.log('Print something');
}

• file-2.ts添加导入声明：

import { function_1 } from '../folder-1/file-1.ts';

function function_2() {
    function_1();
}

配置和代码修改完成后，重启VSCode的TypeScript服务（按Ctrl+Shift+P唤起命令面板，选择TypeScript: Restart TS Server）即可生效，后续缺失导入的代码会被正常标红提示，编译环节也会提前拦截错误。

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