如何在TSC中排除node_modules文件夹？配置exclude仍无效

问题根源 #

1. skipLibCheck的局限性：该配置仅跳过.d.ts类型声明文件的检查，对node_modules中的JS文件无效。而你开启了checkJs: true和allowJs: true，TypeScript会检查所有被纳入扫描范围的JS文件。
2. exclude的生效边界：exclude只能排除未被代码显式引用的文件，如果你的代码里import了node_modules中的文件，TypeScript仍会检查这些被导入的依赖文件。
3. 配置结构错误：你把forceConsistentCasingInFileNames、noImplicitReturns、noUnusedLocals放在了compilerOptions外部，这些规则不会生效，必须移入compilerOptions内部。

解决方案 #

1. 彻底忽略node_modules所有文件 #

添加ignorePatterns配置（TypeScript 3.7及以上版本支持），它比exclude更严格，会强制忽略匹配的文件，即使被代码导入也不会检查：

{
  "compilerOptions": {
    // 你的其他编译配置...
  },
  "include": ["src", "test"],
  "exclude": ["node_modules"],
  "ignorePatterns": ["node_modules/**/*"]
}

2. 修正配置结构 #

将顶级的规则选项移入compilerOptions，确保规则生效：

{
  "compilerOptions": {
    "forceConsistentCasingInFileNames": true,
    "noImplicitReturns": true,
    "noUnusedLocals": true,
    "target": "es2015",
    "explainFiles": true,
    "allowJs": true,
    "checkJs": true,
    "skipLibCheck": true,
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "strict": false,
    "module": "esnext",
    "moduleResolution": "node",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "noEmit": true,
    "jsx": "preserve",
    "lib": ["dom", "es2015", "es2020"],
    "baseUrl": "./",
    "paths": {
      "src/*": ["src/*"]
    },
    "types": ["jest", "chrome"]
  },
  "include": ["src", "test"],
  "exclude": ["node_modules"],
  "ignorePatterns": ["node_modules/**/*"]
}

3. 精准排查扫描文件 #

运行tsc --explainFiles命令，查看具体哪些node_modules文件被扫描。如果是个别测试文件或源码导入了特定依赖导致的，可以：

• 调整include范围为更精准的路径，比如"include": ["src/**/*", "test/**/*"]
• 在导入报错依赖的代码行上方添加// @ts-ignore临时忽略（不推荐大规模使用）

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