如何在tsc编译时屏蔽node_modules目录下的错误？

问题分析 #

执行tsc时node_modules目录下的依赖源码文件出现大量错误，skipLibCheck: true和exclude: ["node_modules"]配置未生效，导致CI/CD构建失败。核心原因可能包括：

• 项目直接导入了依赖的源码文件（而非编译后的发布版本）
• Expo的基础配置覆盖了自定义的exclude规则
• isolatedModules等配置触发了对依赖源码的检查

解决方案 #

1. 修正依赖导入路径 #

错误中的文件均来自依赖的src目录（如@rnmapbox/maps/src/components/Camera.tsx），说明项目中可能直接导入了依赖的源码。应改为导入依赖的主入口：

// 错误写法
import Camera from '@rnmapbox/maps/src/components/Camera';

// 正确写法
import { Camera } from '@rnmapbox/maps';

这样TypeScript会使用依赖包自带的类型声明文件（.d.ts），而非编译源码文件。

2. 细化exclude规则 #

全局排除node_modules可能被Expo的基础配置覆盖，尝试明确排除出错的依赖路径：
修改tsconfig.json的exclude数组：

"exclude": [
  "node_modules/@rnmapbox/maps/src",
  "node_modules/@server/api-client/src",
  "node_modules/react-native-paper/src",
  "babel.config.js",
  "metro.config.js",
  "jest.config.js"
]

3. 明确指定include范围 #

添加include字段，强制TypeScript只检查项目自身的源码，避免扫描到node_modules中的文件：

"include": ["src/**/*"],
"exclude": [
  // 原有排除项
]

4. 命令行强制排除 #

如果tsconfig配置仍不生效，直接在执行tsc时添加命令行参数：

tsc --exclude node_modules/@rnmapbox/maps/src --exclude node_modules/@server/api-client/src --exclude node_modules/react-native-paper/src

5. 检查Expo基础配置 #

查看expo/tsconfig.base的内容（可在node_modules/expo/tsconfig.base.json中找到），确认是否存在include字段包含了node_modules的部分路径。如果有，自定义的include/exclude需要覆盖这些规则。

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