TypeScript编译器（Windows+Node）无输出问题排查求助

你遇到的这个情况挺常见的，尤其是在DefinitelyTyped这类以声明文件为主的目录下，结合你说的--listFiles能看到文件但outDir为空，我整理了几个最可能的原因和解决办法：

1. 先查tsconfig的文件匹配规则 #

虽然--listFiles能列出文件，但这是TS默认扫描到的文件，你的tsconfig.json里的include/exclude可能没覆盖到这些文件，或者不小心排除了。

• 打开你的tsconfig.json，确保include数组包含了所有要编译的文件，比如写"include": ["**/*.ts"]就能匹配所有子目录下的.ts文件。
• 同时检查exclude里有没有误加你的源码目录，正常来说exclude只需要排除outDir、node_modules这类目录就行。

2. 确认outDir配置和文件夹权限 #

• 先看tsconfig里的outDir是不是拼写正确，比如别写成小写的outdir（TS配置是大小写敏感的，Windows系统虽然不区分，但TS认这个），路径是不是相对当前工作目录的正确路径。
• 然后右键你的outDir文件夹，检查“安全”选项卡，确保当前用户有写入权限——有时候Node或者TS进程因为权限不够，写不出文件也不会报错，就会导致文件夹空着。

3. 重点：你处理的是声明文件（.d.ts） #

因为你在DefinitelyTyped的types目录下，这里的文件基本都是.d.ts类型声明文件。TS默认不会主动输出这类文件到outDir，必须手动配置相关选项：

• 在tsconfig.json的compilerOptions里加上：

  {
    "compilerOptions": {
      "declaration": true, // 开启生成声明文件
      "emitDeclarationOnly": false, // 如果只需要输出声明文件可以设为true，默认是false
      "outDir": "./dist" // 替换成你的目标目录
    }
  }
  

  要是没开declaration，哪怕TS扫描到了.d.ts文件，也不会输出任何内容。

4. 检查有没有开noEmit选项 #

如果tsconfig里写了"noEmit": true，那TS只会做类型检查，绝对不会生成任何输出文件，这也是常见的坑。

• 把这个选项改成false，或者直接删掉它——默认就是不开启的。

5. 命令行调用的小细节 #

你是用Node调用TSC的对吧？比如node node_modules/typescript/bin/tsc？

• 确保你调用的时候没额外加--noEmit参数，也没通过--project指定了别的tsconfig文件。
• 可以先直接在命令行跑tsc --listFiles --outDir ./你的输出目录，看看能不能正常输出，排除Node调用带来的问题。

6. 有没有隐藏的编译错误？ #

有时候TS有编译错误，但错误信息没显示出来，默认情况下noEmitOnError是开启的，也就是有错误就不输出文件。

• 跑tsc --diagnostics，这个命令会输出详细的编译日志，包括有没有错误、编译了多少文件、最终输出了多少，能帮你快速定位问题。

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