English | 简体中文

Flu CLI for VSCode

Flutter 开发者的终极效率武器 —— 专为 MVVM 架构而生，让工程化触手可及。

🌟 核心价值

Flu CLI 不仅仅是一个代码生成器，它是 Flutter 团队规范和最佳实践的载体。

🚀 极速起步，灵活架构

内置 3+1 模板体系: 预置 Lite (轻量)、Modular (模块化)、Clean (整洁架构) 及原生自带模板。
强大的自定义模板: 支持 Git 仓库和本地路径，快速沉淀团队私有资产。
智能网络层选择: 创建项目时可选择是否包含网络层（Dio + 示例代码），按需引入。

🎨 资源管理，一键搞定 (New)

App Icon 生成: 告别琐碎，一张 1024 图自动适配所有平台图标。
启动图生成: 支持 Logo + 背景色/图模式，自动配置 flutter_native_splash。

🛠️ 全能生成，深度定制

全场景生成: 支持一键创建 Page、ViewModel、Widget、Component、Service、Model、Module。
快捷键加速: Cmd+Shift+G (Mac) / Ctrl+Shift+G (Windows) 快速唤起生成面板，无需鼠标操作。
.flu-cli.json 驱动: 适配任何已有项目结构，支持自定义 Base 类继承、路径映射、后缀命名等。

🧠 智能感知，懂你锁写

动态 Snippets: 根据项目配置文件动态过滤代码片段，只显示当前架构需要的选项。

✨ 功能演示

[!TIP] 无需打开终端，在 VSCode 资源管理器中右键即可触发魔法。

1. 创建新项目

快速基于各种架构模板初始化项目，支持自定义 Git 模板。

创建项目

2. 应用资源管理 (New)

一键生成图标和启动图，告别繁琐的平台适配工作。

资源配置

3. 智能文件生成

支持 Page/VM/Widget 等多种类型，自动关联现有架构。

文件生成

4. 配置文件初始化

一键生成 .flu-cli.json，让插件轻松适配你的老项目。

配置文件

5. 自定义模板管理

支持添加和管理远程 Git 仓库作为你的项目模版。

自定义模板

⏱️ 3 步快速上手

安装扩展: 在商店搜索 Flu CLI 并点击安装。
初始化项目: 如果是现有项目，右键选择 Flu: 初始化项目 生成配置文件。
开始开发: 在文件夹右键选择 Flu: 生成文件，享受高效开发。

📖 核心功能深潜

1. 模板体系对比

模板	核心包	适用场景
Lite	`provider`	追求简单的中小型项目
Modular	`flutter_modular` + `provider`	追求高解耦、多团队协作的项目
Clean	`provider`	严格分层、易于测试的企业级应用

2. `.flu-cli.json` 配置示例

通过配置文件，你可以让 Flu CLI 完美适配你的老项目。

{
  "generators": {
    "page": {
      "path": "lib/ui/pages",
      "withBasePage": true,
      "basePageClass": "AppBasePage",
      "basePageImport": "package:my_app/base/base_page.dart"
    }
  }
}

3. 智能代码片段 (Smart Snippets)

支持动态感知的代码补全，输入前缀即可触发：

页面: stPage, stSimplePage, lessPage
架构: viewmodel, service, model
组件: stWidget, lessWidget, stComponent, component

4. 命令全览 (Command Palette)

命令 (Command)	说明 (Description)	快捷入口
`Flu: 新建项目`	从模版创建新项目	右键菜单 / Palette
`Flu: 生成文件`	生成 Page/VM/Model 等	右键菜单 / Palette
`Flu: 初始化项目`	生成 `.flu-cli.json`	右键菜单 / Palette
`Flu: 配置应用资源`	配置图标与启动图	右键菜单 / Palette
`Flu: 清理缓存`	清除本地模板缓存	Command Palette
`Flu: 更新模板`	更新内置及远程模版	Command Palette
`Flu: 快捷键`	快速唤起	`Cmd+Shift+G` (Mac) / `Ctrl+Shift+G` (Win)

5. 键盘侠专属 (Shortcuts)

Flu CLI 针对键盘操作进行了深度优化。

默认快捷键: Cmd+Shift+G (Mac) / Ctrl+Shift+G (Windows)
智能上下文:
- Explorer: 生成文件到选中目录。
- Editor: 自动识别当前文件目录作为生成目标，不需要手动选择文件夹。
- Fallback: 如果没有上下文，默认使用项目根目录。

自定义快捷键: 如果不习惯默认键位，可以打开 VSCode 的 keybindings.json 添加：

{
  "key": "cmd+n", // 你的偏好
  "command": "flu.generateFile",
  "when": "editorTextFocus || filesExplorerFocus"
}

🔗 相关资源

🤝 社区与反馈

扫描下方二维码加入我们的微信群，与开发者直面交流。

Flu CLI

火叶工作室