TypeScript报错：输出文件未从源文件构建，删特定文件后消失

问题根源分析 #

TS6305错误本质是TypeScript无法关联声明文件（.d.ts）和对应的源文件（.ts），结合你删除src/App.vue或electron/types/AppFrame.ts报错就消失的现象，核心原因是：

• 多tsconfig文件（tsconfig.json和tsconfig.node.json）的编译范围重叠，引发文件处理逻辑混乱
• include/exclude规则冲突，导致AppFrameName.ts未被正确纳入编译，但生成的.d.ts文件被TS检测到
• 模块解析逻辑因两个文件的存在触发了对AppFrameName.ts的异常引用，而编译配置未匹配这个流程

具体修复步骤 #

1. 拆分两个tsconfig的编译范围 #

避免主配置和node配置处理同一份文件：

• 打开tsconfig.json，在exclude中添加electron目录：

{
  "exclude": ["node_modules", "dist", "electron"]
}

• 调整tsconfig.node.json的include，仅覆盖electron相关文件：

{
  "include": ["electron/**/*"]
}

2. 统一声明文件生成规则 #

确保只有负责electron编译的配置生成声明文件，避免路径冲突：

• 在tsconfig.node.json的compilerOptions中明确声明文件输出规则：

{
  "compilerOptions": {
    "declaration": true,
    "outDir": "./electron/types",
    "declarationDir": "./electron/types"
    // 其他原有配置...
  }
}

3. 清理旧编译产物并重新编译 #

• 删除electron/types目录下所有自动生成的.d.ts文件
• 执行tsc -p tsconfig.node.json单独编译electron部分，再启动主项目

4. 检查导入路径正确性 #

确认main.ts中对AppFrameName的导入是源文件路径，而非生成的.d.ts：

import { AppFrameName } from '../electron/types/AppFrameName'

验证修复 #

同时保留src/App.vue和electron/types/AppFrame.ts，执行编译或启动项目，确认TS6305报错消失，项目正常运行。

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