核心功能
fe-cli 是面向现代前端工程化的统一脚手架入口,覆盖 Web SPA、后台管理、移动 H5、Electron/Tauri 桌面端、SSR 服务端渲染、小程序、React Native 移动端及静态建站等 9 大项目类型。通过智能类型检测与路由机制,自动匹配子技能完成框架选型、UI 库集成(shadcn/Ant Design/MUI/Tailwind)、状态管理(Zustand/Redux)及国际化配置。
显著优势
标准化工程底座:强制生成共享公共层,包含 fetch 请求封装(替代 axios)、结构化日志系统(分级、轮转、持久化)、多环境配置(.env 系列)、SCSS 设计令牌及类型安全工具链,从源头解决前端项目"各自为政"的混乱现状。
现代技术栈优先:默认采用 bun 作为包管理器(pnpm 兜底),Vite 作为构建工具,原生 fetch 作为网络层,目标 Node 18+;同时保留对 Electron/Tauri 等特殊场景的 TypeScript 编译支持,兼顾性能与兼容性。
AI 友好设计:生成 .ai/PROJECT.md 文档,包含完整目录树、技术栈摘要、架构约定与关键模式,大幅降低 AI 助手理解项目的成本,为后续智能化迭代奠定基础。
现有项目审查:支持对存量前端项目进行规范性审计,覆盖包管理器、路径别名、CSS 预处理器、环境文件、请求封装、日志系统等 12 项检查点,输出符合/缺失/建议三级报告,便于技术债治理。
潜在局限
- 生态锁定风险:深度绑定 Vite 体系,对 Webpack 项目迁移成本较高;部分配置(如 logger 实现)需手动适配非 Vite 场景。
- 子技能依赖:9 大类型拆分为独立子技能,实际体验取决于子技能实现完整度,存在功能参差不齐的可能。
- 部署场景单一:默认推荐 Vercel,国内私有化部署需额外配置;Electron/Tauri 的自动更新、代码签名等高级特性未在文档中体现。
适合人群
- 需要快速启动标准化前端项目的中小型研发团队
- 希望统一技术栈、减少"脚手架复制粘贴"的技术负责人
- 需要审查存量项目规范性的前端架构师
- 追求现代工具链(bun/Vite/fetch)的全栈开发者
常规风险提示
| 风险等级 | 场景 | 说明 |
|---------|------|------|
| ⚠️ 中 | 目录已存在 | 覆盖/合并/取消需人工确认,避免误删数据 |
| ⚠️ 中 | 依赖安装失败 | 网络代理或 registry 配置问题,需手动切换淘宝镜像 |
| ⚠️ 低 | 模板包版本不存在 | 降级为手动指定版本,不阻塞流程 |
| ⚠️ 低 | 占位值未替换 | `com.example.app` 等默认值需用户二次确认 |
安全提示:security_level: S 基于工具本身仅为本地脚手架生成,不涉及敏感数据操作;但实际生成项目若包含 API 密钥占位符,需确保 .env 文件不被误提交至版本控制。