WebStorm传递不存在的组件Prop时不显示TypeScript错误排查

以下是几个可能导致该差异的排查点，按优先级排序：

• 检查WebStorm的TypeScript服务配置
  打开WebStorm设置（File > Settings），进入Languages & Frameworks > TypeScript：

  • 确保两个项目均选择项目本地的TypeScript版本（而非全局或WebStorm捆绑版本）；
  • 确认勾选了Enable TypeScript compiler和Use tsconfig.json选项，确保WebStorm严格遵循项目的tsconfig配置。

• 检查WebStorm代码检查开关
  进入Settings > Editor > Inspections，找到TypeScript > General > Unused property：

  • 确保该检查项已启用，且严重程度设置为至少警告；
  • 同时检查TypeScript > React分类下的Excess property in component相关检查是否开启。

• 确认文件类型与语法规范

  • 确保组件文件的扩展名是.tsx而非.jsx/.js，TypeScript的严格类型检查仅对.ts/.tsx文件生效；
  • 检查Test组件的定义是否存在// @ts-ignore、// @ts-nocheck等注释，这些会临时禁用TypeScript检查；
  • 确认Props类型中没有添加[key: string]: any这类索引签名——该签名会允许任意属性传入，导致多余属性检查失效。

• 验证依赖版本一致性
  对比两个项目的package.json：

  • 确保typescript、@types/react、@types/react-dom的版本完全一致；
  • Next.js项目中，next版本也需匹配，不同版本的Next.js TypeScript插件可能影响类型检查逻辑。

• 重新生成Next.js类型文件
  在有问题的项目中：

  1. 删除.next文件夹；
  2. 执行npm run build或next build重新生成类型文件；
  3. 重启WebStorm开发服务器。
     Next.js的类型插件依赖.next/types下的自动生成文件，文件损坏或缺失可能导致检查失效。

• 清理WebStorm缓存
  如果以上步骤均无效，尝试执行File > Invalidate Caches... > Invalidate and Restart，清除WebStorm的缓存数据——缓存异常可能导致类型检查行为不一致。

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