用途:这是一套 React Native 项目的基线约定,用于在搭建项目、编写新代码或审查改动时保持结构与风格一致。适用平台为 iOS 与 Android,React Native 0.76+(默认新架构互操作)。它属于跨所有工作通用的约定,而非单一活动,另可参考架构、测试与代码审查相关技能。
主要能力与要求: 项目结构:src/features/{name}/ 下每个功能一个文件夹;功能之间只通过 shared/ 模块共享代码,禁止跨功能导入;每个功能通过 barrel index.ts 暴露公共 API;关注点分离为 screens(布局)、components(可复用 UI)、hooks(逻辑)、utils(纯函数)。 TypeScript:禁止 any,使用精确类型或 unknown 再收窄;禁止无内联说明的 @ts-ignore;组件 props 使用具名 interface,而非内联对象类型。 命名:技能与功能目录用 kebab-case(如 state-and-data);组件用 PascalCase;hooks 用 useCamelCase;常量用 UPPER_SNAKE_CASE。 文件大小:文件保持在约 300 行以内,函数约 50 行以内,超出时拆分。 代码卫生:提交代码中不留 console.log,改用日志工具;提交中不留注释掉的代码;不留没有关联工单的 TODO。 提交与审查:改动保持聚焦,尽量一个 PR 一个逻辑变更;请求审查前先跑聚焦技能清单(见 code-review 技能)。
使用方式:在新建项目或功能、编写新代码、审查改动时对照上述条目执行。
限制与注意:约定只有一致应用才有效,一个功能无视结构会让整个代码库更难导航;文件大小限制应视为提示信号而非硬性规则,机械套用会导致别扭的拆分。资料未提供安装命令、价格或平台支持细节。