症状
在源码根之上或其旁新增文件后,出现 error TS6059: File is not under rootDir。当测试或共享配置位于 src 之外时尤为常见。
诊断
读取出错路径并与 rootDir 对比:
{ "compilerOptions": { "rootDir": "src", "outDir": "dist" } }
位于 config/load.ts 的文件在该 rootDir 下无法输出。
修复
让根与实际输入对齐:
{ "compilerOptions": { "rootDir": ".", "outDir": "dist" } }
或将文件移入 src,或单独编译测试。
验证
tsc 完成且不报 TS6059,输出目录结构与配置的根一致,确认每个输入都共享声明的基准目录。