用途:这是编写或修改所有 React/TypeScript 代码时遵循的权威标准,强调类型安全、显式错误处理与统一组件模式。资料称“每条规则都必须遵守,而非建议”。
主要能力:一、TypeScript 严格配置,使用 typescript-eslint 的 strict 与 type-checked 预设,禁止 any、非空断言、@ts-ignore、空对象类型、Function、object 等;tsconfig 启用 strict、noUncheckedIndexedAccess、exactOptionalPropertyTypes 等,并配置 @/* 路径别名。二、类型安全要求,禁止 any、{}、object、Function、! 断言及对象字面量 as,替代方案为 unknown、显式联合、受限泛型、具体接口或 Record<string, unknown>。三、Result 模式,所有可能失败的操作返回 Result<T,E>,区分 API 层 ApiResult、Store 层 StoreResult,并显式映射,避免 API 错误泄漏到 UI。四、分层错误处理:API 层捕获异常返回 ApiResult,Store 层映射并设置用户可见错误状态,组件层渲染错误 UI,表单层将服务端字段错误映射回字段,渲染崩溃由 ErrorBoundary 接管。五、动态数据用 Zod 校验,外部数据(API 响应、JSON.parse、环境变量、表单、路由参数)均需验证。六、组件模式,仅具名导出(Next.js page/layout 除外)、显式返回类型、props 只读、状态显式类型、异步事件自行处理错误。
使用方式:资料未提供安装命令或调用步骤,仅给出规则与示例代码。
适用场景:React/TypeScript 项目的日常开发与代码审查,含 Next.js App Router 场景。
限制:未提供价格、平台、效果等事实;相关配置与安装方式暂未提供。