Next.js项目执行npm build时TypeScript错误未触发的问题

我明白你现在的困惑——你故意在Knot类的构造函数里把boolean类型的locked参数赋值给了声明为number类型的实例属性，编辑器已经正确标出了这个类型错误，但执行npm run build时却完全没报错，而且你确认没有设置ignoreBuildErrors: true配置。结合你使用TurboRepo和给出的tsconfig，我来帮你分析原因和解决办法。

问题根源 #

Next.js的next build命令默认不会自动执行TypeScript类型检查：它只会专注于编译代码生成生产构建产物，哪怕存在TS类型错误也会继续执行。而你的编辑器能检测到错误，是因为编辑器（比如VSCode）会实时调用TypeScript编译器做增量检查，但这个过程和构建流程是完全分开的。

另外你用了TurboRepo，如果没有在Turbo的任务管道里配置类型检查的依赖，Turbo在执行build时也不会主动触发TS检查流程。

解决方案 #

1. 添加类型检查脚本，让build依赖它 #

首先在你的package.json里新增一个类型检查的脚本，然后修改build命令，让它先执行类型检查，只有检查通过才会继续构建：

{
  "scripts": {
    "type-check": "tsc --noEmit",
    "build": "npm run type-check && next build"
  }
}

tsc --noEmit命令会让TypeScript编译器做完整的类型检查，但不会生成编译产物（这和你tsconfig里noEmit: true的设置匹配）。一旦检测到类型错误，这个命令会直接报错退出，阻止后续的build执行。

2. 适配TurboRepo的monorepo配置 #

如果你是在TurboRepo的monorepo环境下，需要在根目录的turbo.json里配置任务管道，让build任务依赖type-check，确保构建前先执行类型检查：

{
  "pipeline": {
    "type-check": {
      "dependsOn": ["^type-check"],
      "outputs": []
    },
    "build": {
      "dependsOn": ["type-check", "^build"],
      "outputs": [".next/**"]
    }
  }
}

这样当你执行turbo build时，Turbo会先在所有依赖的包中执行type-check，再执行当前包的build，任何类型错误都会打断整个构建流程。

3. 确认tsconfig的严格检查生效 #

你的tsconfig里已经开启了strict: true，这确保了类型检查的严格性，只要执行tsc --noEmit就会捕捉到你故意留下的boolean赋值给number的错误。虽然你设置了noImplicitAny: false和strictNullChecks: false来覆盖strict的部分规则，但这不影响当前这个明显的类型不匹配错误的检查。

验证方法 #

你可以先单独执行npm run type-check（monorepo下执行turbo run type-check），看看是否会输出你预期的类型错误。如果能正常输出错误，那修改后的build命令就会在构建前拦截这些问题了。

备注：内容来源于stack exchange，提问作者Vipul Rajan