为何React+TS项目用eslint-config-airbnb-typescript仍报ESLint props校验错？关react/prop-types对吗？

关闭react/prop-types是完全正确的处理方式 #

全量使用TypeScript的React项目，本就不需要额外引入React的prop-types校验：

• 你已经通过React.FC<PageProps<ProductsQuery>>为组件声明了完整的props类型，覆盖了Gatsby注入的页面上下文、路由参数等内置属性
• 嵌套的ProductsQuery类型由gatsby-plugin-graphql-codegen自动生成，已经精确约束了GraphQL查询返回的字段结构、空值规则，校验精度远高于prop-types的运行时浅校验
  这种场景下强行写prop-types不仅没有实际作用，还会造成两套类型定义需要同步维护的额外负担。

为什么会触发prop-types相关报错 #

报错的核心原因来自ESLint配置的设计逻辑：

• 基础eslint-config-airbnb是面向纯JavaScript React项目设计的，默认强制开启react/prop-types规则，要求所有组件必须通过propTypes对象声明props的运行时校验规则
• eslint-config-airbnb-typescript并不是直接把所有prop-types相关规则全部屏蔽，它的设计目标是：优先识别组件上的TypeScript类型定义，自动跳过对应的prop-types校验要求。但在两类场景下会出现识别失效：
  • 版本不匹配：如果使用的eslint-plugin-react、eslint-config-airbnb-typescript版本过旧，会对带嵌套泛型的组件类型（比如你用到的PageProps<ProductsQuery>这种从Gatsby导入、嵌套了代码生成类型的泛型）存在识别疏漏，无法判断你已经完成了类型声明，就会触发报错
  • 配置加载顺序错误：如果ESLint配置里，基础airbnb配置块的加载顺序在airbnb-typescript配置之后，部分旧版本的配置合并逻辑会用基础airbnb的原生规则覆盖掉TypeScript适配后的规则，直接触发纯JS场景下的prop-types强制校验

可选的配置优化 #

如果不想全局完全关闭该规则，也可以调整规则参数实现更精准的适配：

// .eslintrc 配置示例
'react/prop-types': ['error', { skipUndeclared: true }]

这个配置会跳过所有已经通过TypeScript声明类型的组件，只对没有任何类型声明的纯JS组件保留prop-types校验要求。对于全量TypeScript的项目，直接全局关闭该规则是最简洁、没有副作用的选择。

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