如何让Vercel CLI在Turborepo Monorepo的Serverless项目中正确忽略node_modules目录以避免TypeScript错误

我理解你在Turborepo monorepo的serverless子项目里遇到的Vercel CLI扫描node_modules导致TS报错的问题——手动跑tsc一切正常，但Vercel就是不放过node_modules里的类型文件。结合你已经尝试的exclude和overrides方法，我整理了几个更针对性的方案，帮你让Vercel CLI乖乖忽略node_modules：

方法1：强化tsconfig的路径排除规则 #

因为你的项目是monorepo结构，子项目的node_modules可能存在于根目录或子项目自身目录，单一的"node_modules"排除规则可能覆盖不全。调整你的tsconfig.json：

{
  "include": ["api/**/*.ts"], // 只扫描业务代码目录，缩小检查范围
  "exclude": ["**/node_modules/**"], // **/ 匹配所有层级的node_modules目录
  "compilerOptions": {
    // 保留你原有的配置，重点确保这两个参数：
    "skipLibCheck": true, // 跳过库文件的类型检查，从根源避免node_modules类型报错
    "strict": true,
    "target": "ESNext",
    "lib": ["dom", "dom.iterable", "esnext"],
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "noEmit": true,
    "esModuleInterop": true,
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "incremental": true
  }
}

这里的**/node_modules/**会匹配子项目内、根目录下甚至任何嵌套层级的node_modules目录，而明确指定include为业务代码目录，能让TS只处理你关心的文件，彻底减少扫描范围。

方法2：强制Vercel CLI使用子项目的tsconfig #

有时候Vercel CLI在monorepo里会出现路径解析混乱，没有正确读取子项目的tsconfig。你可以在子项目的package.json里添加自定义构建命令，明确指定tsconfig路径：

{
  "scripts": {
    "vercel-build": "vercel build --tsconfig ./tsconfig.json"
  }
}

之后运行npm run vercel-build来触发Vercel构建，这样它会强制使用你指定的子项目tsconfig，而不是依赖自动检测的逻辑。

方法3：通过vercel.json锁定Vercel的工作根目录 #

在项目根目录（或子项目目录）创建/修改vercel.json，将工作根目录指定为你的serverless子项目，这样Vercel会完全以子项目为中心处理，不会扫描根目录的node_modules：

{
  "root": "apps/serverless",
  "buildCommand": "turbo run build --filter=serverless" // 结合Turborepo的filter命令只构建当前子项目
}

设置root后，Vercel的所有路径解析都会相对于apps/serverless，你的tsconfig里的exclude规则就能精准生效，不会再“越界”扫描上级目录的node_modules。

方法4：验证并优化依赖覆盖配置 #

你已经尝试了overrides来对齐@vercel/node的ts-node和TS版本，这里需要确保配置生效：

• 如果你是在根目录的package.json里设置overrides，要确保Turborepo的workspaces配置会继承这个覆盖规则；如果是子项目的package.json，直接在子项目里运行npm ls ts-node，确认版本是10.9.2，且typescript版本和你指定的$typescript一致。
• 若overrides没生效，可以尝试在子项目的package.json里直接指定ts-node的版本到devDependencies，强制覆盖@vercel/node带来的依赖。

方法5：禁用Vercel自动TS检查，改用自定义命令 #

如果以上方法都没解决，可以直接让Vercel放弃自带的TS检查，改用你自己的tsc命令：
在子项目的vercel.json里添加：

{
  "typescript": false,
  "buildCommand": "tsc --noEmit && vercel build"
}

这样Vercel会跳过自身的TS检查流程，完全使用你本地验证过的tsc命令，而你的tsc会严格遵循tsconfig的exclude规则，彻底忽略node_modules。

你可以先从方法1和方法3开始尝试，这两个是monorepo场景下最常见的解决方案，通常能快速解决Vercel扫描node_modules的问题。

内容来源于stack exchange