Three.JS+react-three-fibre+vite项目build失败，tsc报类型相关错误求助

已安装@types依赖仍提示找不到类型声明 #

• 检查tsconfig.json中compilerOptions.typeRoots配置项，若你手动配置了该字段，必须包含node_modules/@types路径，否则TS无法识别全局类型声明，参考配置：

{
  "compilerOptions": {
    "typeRoots": ["node_modules/@types", "src/types"]
  }
}

• 确认依赖安装完整性：除three主库外，需额外安装@types/three类型包；若使用了@react-three/fiber、@react-three/drei等封装库，也需要安装对应库的官方类型包。
• 新增gltf/glb资源声明：TS默认无法识别3D模型文件后缀，在src目录下新建declarations.d.ts文件，添加如下内容即可：

declare module '*.gltf' {
  const content: string;
  export default content;
}
declare module '*.glb' {
  const content: string;
  export default content;
}

node_modules内存在类型约束违反 #

• 优先校验TS版本兼容性：新版@types/three、@types/react均要求TS版本≥4.9，若项目TS版本过低，升级TS版本到适配范围即可解决。
• 跳过第三方库类型检查：若无需校验第三方库类型，直接在tsconfig.json的compilerOptions中添加"skipLibCheck": true配置即可，该配置不会影响业务代码的类型校验，是解决第三方包类型冲突的通用方案。

额外校验项 #

• 检查build脚本配置：若使用Vite作为构建工具，无需在build脚本中额外添加tsc命令，Vite内置的TS校验会自动执行，重复调用tsc可能触发异常。
• 清理缓存重试：删除node_modules、锁文件、.tsbuildinfo缓存文件后重新安装依赖再构建，可解决依赖安装不全、缓存异常导致的偶发类型错误。

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