如何通过 tsconfig 与编译流程建立可靠的前端类型检查边界

# 核心结论

可靠的前端类型检查边界，需要同时约束“哪些文件参与检查、按照什么环境解析、检查严格到什么程度、检查失败能否阻断交付”。tsconfig.json 不只是代码生成配置，它还定义项目文件集合、模块解析方式、运行环境类型、严格性规则以及多项目依赖关系。实际工程中应让打包器负责语法转译和资源处理，让 tsc --noEmit 独立执行完整类型检查，并在持续集成中把该命令设为必须通过的质量门禁。打包成功只说明工具能够生成产物，不代表程序已经通过类型检查。

# 底层机制

TypeScript 编译器读取配置后，先根据 files、include、exclude、导入关系和项目引用建立程序文件集