在嵌入式 GUI 项目的开发过程中，设计与工程的衔接一直是个关键问题。通常，界面设计会在 Figma 中完成，但工程实现却要在 GUI Guider 里重新搭建控件层级、配置资源并验证效果。对于页面较多或者迭代频繁的项目而言，这个过程不仅繁琐重复，还容易导致设计与实现之间出现偏差。而 Figma to GUI Guider 插件的出现，为解决这一问题提供了有效的途径，它能够实现设计与工程的顺畅连接，加速嵌入式 GUI 从设计稿到项目的落地进程。
　　该插件提供了一种结构化的转换方式，它能够将 Figma 中的图层和组件映射到 LVGL 控件，生成 GUI Guider 项目 JSON，并且导出为可导入 GUI Guider 的项目包。转换结果可作为工程开发的起始点，后续还能在 GUI Guider 中继续进行编辑、仿真和部署验证。不过需要注意的是，此插件适合用于缩短 “设计交付到工程实现” 的初始转换路径。Figma 设计稿只能作为实现参考，不能完全保证嵌入式运行时的效果，实际项目还需结合目标平台的资源限制和渲染能力进行适配。
　　插件具备以下能力来实现设计与工程的连接：
　　读取 Figma 设计结构：在插件面板展示 Figma Design Tree，方便开发者查看设计节点层级。
　　配置 LVGL 类型映射：为每个设计节点设置合适的 LVGL widget 类型，还能控制节点是否参与转换。
　　生成 GUI Guider 项目 JSON：执行转换后，可在输出区域预览生成的 GUI Guider 项目 JSON。
　　导出项目包：通过 Download 操作导出 zip 包，其中包含转换后的项目文件和相关图片资源。
　　导入 GUI Guider：解压导出的项目包后，可在 GUI Guider 中通过 Import Project 导入.guiguider 文件继续开发。
　　在 Figma 中运行该插件也十分便捷，它已发布在 Figma Community，可直接在 Figma 桌面应用或浏览器版本中运行，无需手动插件包，当前支持 Windows 平台。具体操作步骤如下：
　　打开 Figma 桌面应用或浏览器版本，登录 Figma 账号。
　　进入 Figma to GUI Guider 插件页面，或在 Figma Community 中搜索插件名称。
　　在插件页面点击 Open in… 直接运行，或保存到账号中以便后续使用。
　　打开目标设计文件，在 Plugins 菜单中启动插件；也可以在画布中右键，通过 Plugins 菜单运行。

　　插件启动后会以面板形式显示在 Figma 工作区内。首次使用时，建议先了解几个区域再进行映射和转换：

　　Figma Design Tree：展示当前设计文件中的图层和组件层级，每个节点可配置 LVGL 类型和转换状态。
　　Design Node：展示节点名称与 Figma 类型，并通过 LVGL Type Selector 设置转换后的控件类型。
　　Refresh / Convert：Refresh 用于重新加载当前 Figma 文件结构；Convert 用于根据当前映射配置执行转换。
　　About：查看插件信息、版本、支持联系方式和参考链接。
　　GUI Guider Project JSON：转换后显示生成的项目 JSON，便于快速检查结构。
　　Clear / Copy / Download：分别用于清空结果、复制 JSON、导出项目 zip 包及图片资源。
　　推荐的工作流是先调整映射，再生成项目。插件首次打开时会根据 Figma 节点生成初始映射，先检查和调整节点映射，通常能得到更符合工程预期的项目结构。具体步骤为：
　　检查自动映射：浏览设计树，确认文本、按钮、图片等节点是否被分配了合理的 LVGL 控件类型。
　　调整控件类型：若自动映射不符合预期，可通过 Type Selector 修改节点类型；映射设置会保存在 Figma 项目中。
　　控制转换范围：对不需要输出的节点使用 Disable in Conversion，被禁用节点不会出现在生成 JSON 中，但其子节点仍保留层级关系。
　　执行 Convert：完成配置后点击 Convert，生成 GUI Guider 项目 JSON，并在输出区域检查结果。
　　转换完成后，先在 GUI Guider Project JSON 区域快速检查结构。若节点类型、层级关系或禁用状态不符合预期，可返回设计树调整映射，并再次执行 Convert。确认结果后，点击 Download 导出 zip 包，解压后在 GUI Guider 选择 Import Project，选择解压目录中的.guiguider 文件完成导入。若设计使用自定义字体，需将字体文件复制到项目目录的 resources/font 文件夹。导入后，开发者可继续在 GUI Guider 中编辑界面，并进行运行验证。
　　该插件尤其适合已有 Figma 设计稿、希望快速生成 GUI Guider 工程起点的团队。对于页面结构较清晰、需要频繁迭代，或希望减少设计交付与嵌入式 GUI 开发之间重复沟通的项目，它可以作为设计到工程落地流程中的辅助工具。使用时，设计结构应尽量贴近控件层级，将转换结果视为工程起点，若 GUI Guider 导入不成功，可删除之前导入的设计项目，在干净状态下重新导入。
　　Figma to GUI Guider 插件为 Figma 设计稿与 GUI Guider 工程之间搭建了更直接的连接桥梁。通过设计树解析、LVGL 类型映射、节点转换控制、JSON 预览和项目包导出，开发者能够更高效地将已有设计资产融入 GUI Guider 工作流，并在后续阶段完成工程化编辑、仿真和目标平台验证。对于已经采用 Figma 进行界面设计的团队来说，这一插件可以有效减少重复搭建界面的工作量，使设计交付与嵌入式 GUI 开发之间的协作更加顺畅。