"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo"

### 关于 `tsBuildInfoFile` 的配置说明

#### tsBuildInfoFile 参数解释
TypeScript 编译器提供了一个名为 `incremental` 和 `tsBuildInfoFile` 的选项来启用增量编译功能。当启用了此特性之后，TypeScript 将会保存有关先前构建的信息到指定文件中以便加速后续的构建过程。

对于 `tsBuildInfoFile './node_modules/.tmp/tsconfig.app.tsbuildinfo'` 这样的设置意味着：

- 增量编译信息将会被存储在一个特定路径下的 `.tsbuildinfo` 文件里，在这个例子中就是位于项目根目录下 `./node_modules/.tmp/` 路径中的 `tsconfig.app.tsbuildinfo` 文件。

该参数通常用于大型项目以减少重新编译整个项目的开销并提高开发效率[^1]。

#### 配置方式
为了使用自定义位置作为 `tsBuildInfoFile` ，可以在 `tsconfig.json` 中加入如下字段:

{
  "compilerOptions": {
    ...
    "incremental": true,
    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo"
  }
}

这告诉 TypeScript 使用相对路径指向的目标文件来进行增量编译记录。

#### 可能遇到的问题及解决方案

##### 清除缓存数据
如果发现某些错误持续存在或者更新后的代码未生效，则可能是由于旧版的 .tsbuildinfo 文件导致的问题。此时可以尝试删除对应的`.tsbuildinfo` 文件让 TypeScript 创建新的增量信息文件。

##### 权限不足
有时可能会因为权限问题无法写入指定的位置特别是像 `/usr/local/lib/node_modules/`这样的全局安装包所在区域。这时可以通过调整文件夹访问权限命令如 `chmod` 或者选择其他有足够权限读写的本地路径来解决问题[^3]。

##### 插件依赖缺失
在一些情况下，第三方库或插件可能也会间接影响到 TypeScript 构建流程。例如 UmiJS 插件注册失败的情况就表明可能存在缺少必要的模块（比如 React）。因此确保所有必需的依赖项都已正确安装是非常重要的[^4]。