让错误浮现

构建悬挂了。

不是偶尔卡顿，而是彻底停止。进度条不动，终端无响应，只能强制退出。这种问题最令人沮丧，因为它不给你任何线索。

问题不在 Next.js，也不在 TypeScript。问题在于我们选择了掩盖。

掩盖的诱惑

打开 next.config.js，看到这行配置：

typescript: {
  ignoreBuildErrors: true
}

再看 tsconfig.json：

{
  "compilerOptions": {
    "strict": false,
    "skipLibCheck": true
  }
}

这两个配置共同完成了一件事：让类型错误消失。不是修复，是隐藏。

为什么会这样配置？通常是因为：

• 遗留代码太多，类型错误修不完
• 赶项目进度，先让它能跑起来
• 不理解严格模式的价值，觉得它碍事

但掩盖问题从来不会让问题消失。它们只是转移到更难发现的地方。

错误的本质

错误不是敌人。错误是信号。

当 TypeScript 报告类型错误时，它在说："这里的逻辑不够清晰，可能会出问题。"当构建系统悬挂时，它在说："有些东西不对劲，我无法处理。"

如果我们选择忽略这些信号，系统就会进入一种混乱状态：

• 类型系统无法提供准确的推导
• 构建工具不知道如何处理不明确的代码
• 运行时可能遇到意外的类型冲突

这不是工具的问题，是我们选择掩盖的结果。

参考 fast-type-checking 了解类型检查的性能优化方法，参考 extending-typescript-config 了解如何合理配置 TypeScript。

让错误浮现

修复的方法很简单：停止掩盖。

首先修改 next.config.js，移除或改为：

typescript: {
  ignoreBuildErrors: false
}

然后修改 tsconfig.json，启用严格模式：

{
  "compilerOptions": {
    "strict": true
  }
}

接下来运行类型检查：

npx tsc --noEmit

这个命令会暴露所有被掩盖的类型错误。可能有几十个，甚至几百个。这很正常。这些错误本来就在那里，只是被隐藏了。

现在你面对的是真实的问题清单。逐个修复它们。可能需要几个小时，甚至几天。但每修复一个错误，代码就变得更清晰、更安全。

当所有错误都解决后，再次运行构建：

npm run build

构建不会再悬挂。因为那些导致混乱的隐患已经被清除。

质量不是选项

严格类型检查不是额外的工作，而是基本的质量保证。它不会拖慢开发速度，反而会减少调试时间和线上问题。

当你选择 ignoreBuildErrors: true 时，你在说："我不在乎这些错误。"但系统会在乎。它会用更隐蔽、更难修复的方式提醒你。

当你选择 strict: false 时，你在说："我不需要类型安全。"但类型安全不是可有可无的装饰，它是代码可维护性的基础。

技术债不是欠了多少行代码要重写，而是欠了多少问题要解决。每一个被掩盖的错误都是一笔债。利息会复利增长。

让错误浮现，不是为了制造麻烦，而是为了面对真相。只有看到问题，才能解决问题。

最后

构建悬挂问题修复了。不是因为我们找到了某个神奇的配置，而是因为我们停止了掩盖。

那些被忽略的类型错误终于暴露出来，被逐个修复。代码变得更清晰，构建变得更稳定。

这不是一个关于技术的故事，而是关于选择的故事。每一次选择掩盖问题，我们都在为未来的混乱买单。每一次选择面对问题，我们都在为长期的质量投资。

质量不是一次性的行动，而是持续的选择。

选择让错误浮现，而不是让它们沉没。