React+TypeScript编译未因明显TS错误终止，求排查指导

• 检查tsconfig.json核心配置

  • 确认compilerOptions里的noEmitOnError设为true：这个配置直接控制TypeScript在检测到错误时是否停止生成编译产物，是让构建失败的关键开关。
  • 确保strict模式处于开启状态：strict: true会启用一系列严格类型检查规则（比如strictNullChecks、noImplicitAny等），如果被改为false，很多类型错误会被忽略。
  • 示例配置片段：

    {
      "compilerOptions": {
        "noEmitOnError": true,
        "strict": true,
        // 其他原有配置...
      }
    }
    

• 排查TSC_COMPILE_ON_ERROR环境变量

  • react-scripts允许通过这个环境变量强制忽略TypeScript错误继续构建。检查项目的.env文件（包括.env.development等环境特定文件）里是否有TSC_COMPILE_ON_ERROR=true，如有则改为false或删除。
  • 同时检查启动脚本，确保没有在react-scripts start前添加该变量前缀，比如不要写成TSC_COMPILE_ON_ERROR=true react-scripts start。

• 检查自定义构建配置（若使用eject/craco/react-app-rewired）

  • 如果项目已经eject过，打开webpack.config.js，查找ts-loader或babel-loader的配置，确认没有设置transpileOnly: true——这个选项会跳过TypeScript类型检查，只做代码转译，导致错误不会阻断构建。
  • 如果使用craco，检查craco.config.js，确保typescript.enableTypeChecking设为true：

    module.exports = {
      typescript: {
        enableTypeChecking: true
      }
    };
    

• 确认ESLint配置（辅助检查）

  • 虽然VS Code能检测到TypeScript错误，但如果ESLint没有将TypeScript相关规则设为错误级别，可能不会在构建阶段阻断。检查.eslintrc或相关配置文件，确保@typescript-eslint的核心规则（比如@typescript-eslint/no-explicit-any等）的级别设为error。

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