核心用法
fe-cli 是一个覆盖 6 大前端场景的项目初始化工具:Web SPA、后台管理、移动 H5、Electron 桌面端、SSR (Next.js/Nuxt) 及小程序。通过关键词自动识别项目类型,路由至专属子技能完成脚手架生成。
快速模式:用户可直接指定技术栈,如「React + Tailwind + Zustand 后台项目」,跳过交互直接生成。
交互模式:模糊输入时,系统依次询问项目类型、框架偏好、UI 库、状态管理方案等。
共享公共层:所有项目自动生成标准化基础设施,包括 fetch 请求封装、结构化日志(分级、轮转、5MB 自动清理)、多环境配置、SCSS 变量体系及路径别名 @/ → src/。
AI 可读文档:生成 .ai/PROJECT.md,包含完整目录树、技术栈摘要、架构约定及关键模式,便于后续 AI 代理维护。
显著优点
- 类型覆盖全面:从传统 SPA 到 Electron、SSR、小程序,单入口统一管控
- 工程规范强制落地:包管理器锁定 pnpm、原生 fetch 替代 axios、Sass 作为默认 CSS 预处理器,避免团队选型争议
- 日志与可观测内置:结构化日志 + 导出/上报能力,非事后补丁
- 降级策略完备:网络失败、目录冲突、版本不存在等场景均有预设处理路径
潜在缺点与局限性
- 技术栈 opinionated:强制 pnpm、Sass、fetch 封装,与团队现有习惯冲突时需适配
- Node 18+ 门槛:旧环境无法直接运行
- 子技能依赖:实际执行需配合 fe-cli-admin/fe-cli-h5 等子技能,单技能无法独立完成全流程
- 部署环节缺失:明确拒绝服务器部署请求,需外部工具衔接
适合人群
- 需要快速启动标准化前端项目的全栈开发者
- 技术负责人建立团队工程规范基线
- 审查已有项目合规性的代码审计场景
常规风险
- 版本漂移风险:模板引用的包版本可能不存在,需人工介入指定
- 覆盖误操作:目标目录存在时默认询问,但用户误选「覆盖」将导致数据丢失
- 网络代理依赖:国内用户若未配置 registry 可能遭遇依赖安装失败