用途:在新建项目、项目复杂度增长需要重构、或团队需要统一目录规范时,帮助设计并组织项目文件与文件夹结构,以提升可维护性与可扩展性。
主要能力:提供三类结构模板。一是 React/Next.js 项目结构,包含 app 路由与路由组、components(ui、layout、features、shared)、lib(utils、hooks、api)、store、types、config、styles;二是 Node.js/Express 后端结构,按 api(routes、controllers、middlewares)、services、repositories、models、database、utils、config、types、tests 分层;三是大型应用的按功能划分结构,在 features 下为每个功能放置 components、hooks、api、store、types,并配合 shared 与 core。
使用方式:按步骤选用对应结构模板组织目录;遵循其命名约定,组件用 PascalCase.tsx,hooks 与 utils 用 camelCase.ts,常量为 UPPER_SNAKE_CASE.ts,类型为 camelCase.types.ts,测试为 *.test.ts 或 .spec.ts;文件夹可用 kebab-case。可用 index.ts 桶文件做命名再导出,如 export { Button } from './Button/Button',并避免 export * 影响 tree-shaking。可通过 tsconfig.json 的 paths 配置路径别名 @/,将深层相对导入改为 @/components/ui 形式。
约束与建议:团队需保持规则一致;文件夹名称应明确表达职责;目录深度建议不超过 5 层,避免 7 层以上嵌套;避免 utils2、helpers、misc 等模糊命名;禁止循环依赖。建议同组件相关文件就近放置(colocation)、按功能模块化、使用路径别名。
限制:资料未提供具体安装命令、依赖、平台集成、收费或价格信息,这些暂未提供;兼容平台标注为 Claude、ChatGPT、Gemini,版本 1.0.0。