核心用法
fe-cli 是一款面向现代前端工程化的 CLI 脚手架工具,定位为前端项目的统一入口。它通过路由机制将请求分发至六大专属子技能(fe-cli-web/fe-cli-admin/fe-cli-h5/fe-cli-electron/fe-cli-ssr/fe-cli-miniapp),覆盖 Web SPA、后台管理、移动 H5、Electron 桌面端、SSR 及小程序等主流场景。
显著优点
1. 多技术栈灵活组合:支持 React/Vue/Next.js 框架,Tailwind/Ant Design/MUI UI 库,Zustand/Redux 状态管理,以及 i18n 国际化方案的任意组合,通过"一句话启动"模式或交互式问答完成配置。
2. 标准化公共层:自动生成统一的目录结构、请求封装(fetch-based)、结构化日志系统、多环境配置(.env 系列)、SCSS 设计令牌及类型声明,强制使用 pnpm 和 @/ 路径别名,确保团队代码风格一致。
3. AI 原生设计:生成 .ai/PROJECT.md 文件,为后续 AI Agent 提供完整目录树、技术栈摘要、架构约定和关键模式说明,实现人机协作的无缝衔接。
4. 降级与容错机制:针对网络失败、依赖安装异常、目录冲突等场景提供明确的降级策略和手动修复指引,避免流程阻塞。
潜在局限
- 生态绑定较深:强制使用 pnpm(npm/yarn 用户需切换工具链),且 CSS 预处理器锁定 SCSS,对偏好其他方案的团队存在迁移成本。
- 部署能力缺失:明确限制为"本地项目初始化",不提供 CI/CD、服务器部署等后续环节支持。
- 模板版本风险:引用包版本不存在时不阻塞流程,可能导致运行时兼容性问题。
- Node 版本门槛:要求 Node 18+,旧环境无法使用。
适合人群
- 前端团队负责人:需统一团队项目模板、规范开发流程
- 全栈开发者:快速启动标准化前端层,专注业务逻辑
- AI 辅助开发用户:利用
.ai/PROJECT.md实现项目结构的 AI 可理解性
常规风险
| 风险点 | 说明 |
|--------|------|
| 依赖源配置 | 默认 npm registry 可能因网络受限,需手动配置淘宝镜像 |
| 目录覆盖误操作 | "目录已存在"场景下的 Overwrite/Merge 选择需谨慎 |
| Electron 编译特殊处理 | 主进程需单独 tsc 编译,与渲染层构建逻辑不同 |
| 日志上报占位 | `log-export.ts` 中的上报端点为 TODO 状态,生产环境需自行实现 |