核心用法
fe-cli 作为前端项目脚手架的统一入口,通过自然语言识别项目类型,路由至 9 个专属子技能之一:Web SPA、后台管理(admin)、移动 H5、Electron 桌面端、Tauri 轻量桌面、SSR(Next.js/Nuxt)、微信小程序、React Native、静态建站(Astro/Gatsby)。用户可通过一句话快速启动(如"初始化 React + Tailwind + Zustand 后台项目")或进入交互模式逐步配置。
显著优点
1. 标准化工程体系:强制约定包管理器(bun > pnpm)、CSS 预处理器(SCSS)、路径别名(@/ → src/)、原生 fetch 封装等,杜绝项目风格漂移
2. 完备的基础设施层:自动生成主题系统(亮/暗模式)、状态管理(Zustand/Redux/Pinia)、i18n、日志系统(分级+轮转+导出)、通用 Hooks(10+)、路由守卫、错误边界等
3. AI 协作优化:生成 .ai/PROJECT.md 标准化文档,使 AI 代理快速理解项目架构、技术栈与开发约定
4. 多环境配置:自动产出 .env / .env.development / .env.test / .env.production,支持 dev/test/prod 差异化构建
5. 审查能力:可对已有前端项目进行规范性审查,输出符合/缺失/建议项报告
潜在缺点与局限性
- 强约束性:对偏好自由配置的团队可能过于严格,迁移旧项目成本较高
- Node 版本门槛:目标 Node 18+,老旧环境需升级
- 网络依赖:依赖
bun create/pnpm create拉取模板,网络异常时需手动降级 - 部署范围有限:仅负责本地项目初始化,部署需额外工具;虽推荐 Vercel,但非强制集成
- 模板维护负担:9 种子技能 × 多技术栈组合,模板版本同步挑战较大
适合人群
- 中小型前端团队:需要快速统一技术栈、规范代码结构的场景
- AI 辅助开发流程:频繁使用 AI 编码助手,需要标准化项目文档供 AI 理解的团队
- 多类型项目开发者:同时维护 Web、桌面、移动端等多形态前端项目的个人或组织
- 技术负责人:需要建立团队级脚手架规范、降低新项目启动成本的管理者
常规风险
| 风险类型 | 描述 | 缓解措施 |
|---------|------|---------|
| 依赖安装失败 | 网络波动或 registry 配置错误 | 提供淘宝镜像切换命令,支持手动创建降级 |
| 目录覆盖误操作 | 目标目录已存在时误选覆盖 | 交互确认覆盖/合并/取消,默认不覆盖 |
| 模板版本过时 | 引用的包版本不存在或已废弃 | 提示用户手动指定版本,不阻塞流程 |
| 技术栈冲突 | 用户同时选择 React 和 Vue 等矛盾请求 | 输入澄清机制强制确认单一框架 |
| 越界功能误用 | 误将 fe-cli 用于后端项目或部署 | 明确拒绝非前端请求,重定向至合适工具 |