用途:为 React Native 项目提供结构规范,按功能/模块而非文件类型组织代码,并实现关注点分离。优先级标注为 P0(关键)。
主要能力:按功能组织目录,将屏幕、组件、hooks 就近放在同一功能目录内;UI(screens/components)与逻辑(hooks/services)分离;可复用组件放 /components,功能专属组件放功能目录;通过 tsconfig.json 配置路径别名实现绝对导入;每个文件单一职责。该结构同时适用于 Expo 与 CLI 项目(Expo 用 app.json,CLI 用 index.js)。
导航策略:新项目、需要 Web 一致性与基于文件路由时用 Expo Router;复杂深链、遗留应用或高度定制需求时用 React Navigation。
反模式:避免在根目录使用 /containers、/screens 等按类型划分的文件夹;屏幕组件中不写业务逻辑,应抽到 hooks 或 services;功能之间不得直接互相导入以避免循环依赖;目录嵌套最多 3 层。
验证清单(强制):文件是否位于功能目录内;hooks/services 是否与屏幕就近放置;屏幕组件是否含业务逻辑;项目是否采用上述导航策略。
限制:资料仅给出原则与清单,完整目录树、路径别名配置与服务层模式需参见 references/folder-structure.md,具体代码示例与安装命令暂未提供。