1.0 KiB
1.0 KiB
Context
TypeScript 的 incremental: true 选项会在编译时生成 .tsbuildinfo 文件用于增量编译加速。当 dist/ 目录被清理（如 nest build 的 deleteOutDir: true 行为）但 .tsbuildinfo 缓存未被同步清理时，TypeScript 会基于缓存判定所有文件已是最新、跳过编译，导致运行时找不到输出文件。
Goals / Non-Goals
Goals:
- 将
*.tsbuildinfo加入.gitignore，防止缓存文件被版本控制追踪
Non-Goals:
- 不改变 TypeScript 编译配置
- 不添加自动清理缓存的构建脚本
Decisions
- 方案：在
.gitignore中新增一行*.tsbuildinfo规则，置于「构建产物」区域下方 - 理由：这是最小改动方案。
.tsbuildinfo属于构建产物类文件，应与dist/、build/等同对待；加入.gitignore后既不会被提交，也提示开发者此为自动生成文件
Risks / Trade-offs
- 无风险。该改动仅影响 git 追踪行为，不改变编译或运行逻辑