vue-tsc构建纯TS类型文件失败：未生成dist目录的排查求助

核心问题：tsconfig配置不完整 #

你的tsconfig.build-types.json仅配置了include和exclude，缺少compilerOptions基础编译配置，导致vue-tsc无法正确识别并处理纯类型文件的编译流程。

具体修复步骤 #

1. 完善tsconfig.build-types.json配置 #

添加必要的编译选项，确保TypeScript能正确解析并输出类型文件：

{
  "compilerOptions": {
    "target": "ESNext",
    "module": "ESNext",
    "declaration": true,
    "emitDeclarationOnly": true,
    "outDir": "./dist/types",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true
  },
  "include": ["src/types.d.ts"],
  "exclude": ["node_modules", "**/*.cy.ts", "**/*.spec.ts", "**/__tests__/**/*"]
}

2. 简化执行命令（可选） #

因为配置文件里已经声明了declaration、emitDeclarationOnly和outDir，可以简化命令为：

vue-tsc --project tsconfig.build-types.json

保留原命令也可，命令参数会覆盖配置文件中的对应项。

3. 排查其他可能问题 #

• 路径校验：确认src/types.d.ts文件确实存在，路径拼写无错误（注意大小写，Linux/macOS下路径大小写敏感）。
• 缓存清理：删除node_modules/.cache目录（如果存在），避免旧缓存干扰编译。
• 工具替代验证：如果vue-tsc仍不生效，尝试用原生tsc命令测试：

  tsc --project tsconfig.build-types.json
  

  若tsc能生成dist目录，说明是vue-tsc针对纯类型文件的处理逻辑问题，此时可以用tsc单独处理类型文件，vue-tsc处理Vue组件。

为什么构建Vue组件时正常？ #

当include设为["src/**/*"]时，vue-tsc会处理.vue文件中的类型定义，同时默认加载项目根目录的tsconfig.json（通常包含完整的compilerOptions），所以能正常生成类型文件。但单独处理纯.d.ts文件时，必须提供完整的编译配置。

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