WebStorm 2026.3 Help

Figma 连接

Figma Connect 可让您将 Figma 中的设计引入 WebStorm,并将其用作 Air 的上下文。 选择 Figma Desktop 中的任意图层 — 框架、组件或组,从 Air Chat 引用它,或将引用复制到在 终端 中运行的代理 — 无需在设计与 WebStorm 之间来回切换。

也支持 自带密钥 (BYOK) 方式,因此可以使用兼容 AI 提供商的模型并搭配自己的 API 密钥。

WebStorm 会连接到 Figma Desktop ,通过适用于 Figma 的 JetBrains 连接 插件,将当前选择实时流式传输到 Figma 图层 工具窗口。

开始之前

  1. 确保拥有付费 Figma 席位,并具有 开发模式 或 完整设计 访问权限。 Figma Connect 依赖于 Figma Desktop MCP 服务器 ,无法在 View、Collab 或 Starter 席位 上启用。

  2. 可选:

在 WebStorm 中设置 Figma Connect

WebStorm 提供 Figma Connect 设置向导,引导您完成设置过程,包括安装 AI Assistant 插件和 Figma Desktop 应用程序、在 Figma 中安装 JetBrains Connect 插件,以及将 Figma Desktop 应用程序连接到 WebStorm。

  1. 打开 Figma 图层 工具窗口(视图 | 工具窗口 | Figma 图层 ),然后点击 设置。

    带有设置按钮的 Figma Connect 工具窗口

    按照屏幕上的说明设置 Figma Connect。

  2. 在向导的 获取 Figma Desktop 应用 页面上,如果已有 Figma Desktop 应用程序,请点击 我已安装该应用 ,然后点击 下一步。 否则,请点击 下载。

    Figma Desktop 下载对话框

    WebStorm 会打开 Figma 下载页面。 下载并安装 Figma Desktop 应用程序。 点击 下一步 即可。

    Figma Desktop 已安装。
  3. 请在 在 Figma Desktop 中运行 JetBrains Connect 插件 页面上点击 打开 JetBrains Connect。

    JetBrains Connect 插件安装对话框
  4. 在 JetBrains 连接 页面上,点击 打开 并选择要在其中打开插件的设计文件。

    选择设计文件
  5. 在右侧的 插件 窗格中,点击 运行。

    在 Figma Desktop 中运行插件
  6. 在 插件 窗格中,点击 连接。

    连接到 WebStorm

    之后,插件会继续等待来自 WebStorm 的批准以建立连接。

    正在等待 WebStorm 批准
  7. 请在 在 Figma Desktop 中运行 JetBrains Connect 插件 页面上点击 下一步。

    在 Figma Desktop 中运行插件 - 完成
  8. 在向导的 允许传入连接 页面上,点击 允许 ,然后点击 下一步。

    允许连接
  9. 设置完成后,工具窗口的状态会更改为 已连接。

    带有设置说明的 Figma Connect 工具窗口

    WebStorm 会记住该批准,因此日后会自动接受连接。 要再次要求批准,请使用 撤销所有配对的会话 ,位于工具窗口 设置 中(点击工具栏上的 选项图标 ,选择 插件设置 ,然后选择 撤销所有配对的会话)。

    Figma Connect 工具窗口 - 设置

配置使用 Air 从 Figma 设计生成代码

完成 Figma Connect 设置向导后,WebStorm 会建议设置 Figma Connect 与 JetBrains Air 之间的交互。

  1. 在 Figma 图层 工具窗口中,点击通知工具提示中的 设置 以启动向导

    使用 Figma Connect 设置 Air
  2. 如果 Air 插件已禁用,请在 使用 Air 从你的 Figma 设计生成代码 页面上点击 启用 Air。

    在 Figma Air 设置向导中启用 Air

    WebStorm 会安装 JetBrains Air 插件并重新启动,然后返回 使用 Air 从你的 Figma 设计生成代码 页面。 点击 设置。

    “使用 Air 从 Figma 设计生成代码”页面
  3. 按照 在 Figma Desktop 中启用 MCP 服务器 页面上的说明操作。

    “在 Figma Desktop 中启用 MCP 服务器”页面
    1. 在 Figma Desktop 应用程序中,切换到 开发 模式。

      在 Figma Desktop 中切换到开发模式
    2. 启用 MCP 服务器。

      在 Figma Desktop 中启用 MCP 服务器

    请在 在 Figma Desktop 中启用 MCP 服务器 页面上点击 验证连接。

    WebStorm 会检查 MCP 服务器是否正在运行,以及 Figma Desktop 应用程序是否已连接到该服务器。 向导会关闭,并返回 Figma 图层 工具窗口。

    Figma Air 设置向导已完成

设置 Figma 技能

jb-figma-implement-design 技能随 WebStorm 捆绑提供并自动启用。

设置中的 Figma 技能

在 AI 聊天 工具窗口中开始键入命令时,补全弹出窗口会建议使用该技能。

补全弹出窗口中建议使用 jb-figma-implement-design 技能

查看当前选区和图层

  1. 当前 Figma Desktop 页面上的图层会列在 Figma 图层 工具窗口中。

    • 展开一个图层以浏览其子图层。

    • 使用 当前已选置位到 区域中的预览来定位所需图层。

  2. 将 Figma Desktop 与 WebStorm 同步。

    Figma Connect 会在 Figma Desktop 与 WebStorm 之间实时同步所选内容,减少来回切换。 同步是双向的:

    • 在 Figma 中选择框架、组件或图层时,所选内容会显示在 Figma 图层 工具窗口中。

    • 在 Figma 图层 工具窗口中点击节点时,会在 Figma 中捕获页面上的焦点。

将设计添加到 AI 上下文

使用 Air Context 生成、审查并修改实现设计的代码。

  1. 要将设计用作 Air 的上下文,请指向所需项,然后点击其旁边的 添加图层到 Air 图标。

    选择项上高亮显示的添加图层到 Air 图标

    也可以一次选择并添加多个图层。

    显示当前选择和图层的 Figma Layers 工具窗口
  2. 如果编辑器中已有打开的 Air 会话选项卡,所选图层会自动添加到提示区域。 否则,WebStorm 会打开一个 新建会话 弹出窗口,其中已附加所选设计。

    已添加所选图层的 Air 弹出窗口
  3. 键入提示,并将其与附加的设计一起发送。

    请在你的提示中说明具体需求。 例如,"将当前首页实现与附加的 Figma 设计进行比较,并修复所有视觉或布局差异。"

    附加到 Air 会话的 Figma 设计,其中包含提示,要求将实现与设计进行比较并修复差异。
  4. 默认情况下,WebStorm 会自动将当前所选内容附加到每个新的 AI 上下文。 要更改此行为,请按照 配置 Figma Connect 设置和行为中所述禁用 在 AI 上下文中自动包含所选内容 选项。

将设计添加到 AI Assistant 上下文

虽然强烈建议使用 Air,WebStorm 仍支持与 AI Assistant 集成。

  1. 要将设计用作 AI 聊天 的上下文,请指向 层 窗格中的所需项,然后点击 添加到上下文图标。

    选中项上高亮显示的 Add to Context 图标

    WebStorm 会打开 AI 聊天 工具窗口,并自动附加所选设计。

    AI Assistant 聊天窗口及其高亮显示的工具窗口图标
  2. 在 AI 聊天 工具窗口中输入你的提问,并与所附设计一起发送。

    请在你的提示中说明具体需求。 例如,"将当前首页实现与附加的 Figma 设计进行比较,并修复所有视觉或布局差异。"

    附加到 AI Assistant 聊天的 Figma 设计
  3. 默认情况下,WebStorm 会自动将当前选中内容附加到每个新的 AI 聊天。 要更改此行为,请按照 配置 Figma Connect 设置和行为中所述禁用 在 AI 上下文中自动包含所选内容 选项。

按 id 引用设计和图层

在聊天或终端中的会话期间,可以通过 id 引用设计或图层。

开始之前

  1. 如果连接的是 Figma Remote MCP 服务器 ,请确保拥有 文件密钥。

  2. 建议 设置特定于代理的技能。

或者点击 复制图标 ,它位于 Figma 图层 工具窗口中所需节点旁边,然后将 id 粘贴到 终端 中。

复制节点的 id

通过 ID 引用设计或图层

  • 在 Figma 图层 工具窗口中选择相应节点,然后将所选内容拖到聊天或终端中。 如果只需要针对一个图层,而不是重新生成整个屏幕,这可能会很有用。

  • 在 Figma 图层 工具窗口中,点击所需节点旁边的 复制图标 ,然后将 id 粘贴到聊天或终端中。

    复制节点的 id
  • 右键点击所需项,选择适用的格式,然后将其粘贴到聊天或终端中。

    通过上下文菜单复制节点的 ID

管理样式、布局和颜色

可以直接从 WebStorm 中的专用 Figma 检查 工具窗口处理样式和颜色。

  1. 要检查节点,请在 Figma 图层 工具窗口中选择该节点,然后点击其旁边的 检查图标。

    按 Inspect 图标
  2. Figma 检查 工具窗口会显示所选节点的样式、布局和颜色。

    • 在 Hex、RGB 和 HSL 之间切换颜色表示法。

      显示颜色的 Figma Inspect 工具窗口
    • 将语言从 CSS 切换为 Android: Compose 或 Android: XML ,将 XML 与 Figma 自身针对同一节点的 Dev Mode 输出进行比较。

      Figma Inspect 工具窗口 - 切换语言
    • 要复制布局、样式或颜色的代码,请点击其旁边的 复制图标。

      Figma Inspect 工具窗口复制颜色
    • 要将样式、布局或颜色添加到 AI 聊天 ,请点击其旁边的 添加到上下文图标。

      Figma Inspect 工具窗口 - 添加到上下文
    • 要一次性将节点的样式、布局和颜色代码作为文本复制,请点击 当前正在检查 区域中的 复制图标。

      Figma Inspect 工具窗口 - 全部添加到上下文

      要将其添加到 AI 聊天 ,请点击 添加到上下文图标。

嵌入式 Figma 画布

可以直接在嵌入式编辑器(画布)中编辑设计,而无需切换到 Figma Desktop。

  1. 要启用嵌入式画布编辑器,请前往主菜单上的 帮助 | 查找操作 ,查找 注册表 ,该项位于 Search Everywhere 弹出窗口 中,然后选中 figma.embedded.editor.enabled 旁边的复选框。

  2. 要在画布中打开图层,请在 当前已选置位到 区域中点击它。

  3. 点击工具栏上的 放大图标 或 缩小图标 可放大或缩小所选内容。

  4. 要恢复所选内容的原始大小,请点击 实际缩放图标。

  5. 要自动设置缩放级别,确保所选内容适合嵌入式编辑器,请点击 适合窗口缩放图标。

  6. 要显示棋盘背景,请按 显示棋盘切换按钮。

配置 Figma Connect 设置和行为

  1. 在 Figma 图层 工具窗口的工具栏上点击 选项图标 ,然后从列表中选择 插件设置 "设置"图标。

    Figma Connect 设置菜单
  2. 根据需要配置设置。 如需启用某个设置,请在弹出的列表中为其打勾。

    在 AI 上下文中自动包含所选内容

    自动将当前 Figma 所选内容附加到每个新的 AI 上下文。

    在 IDE 启动时自动启动服务器

    打开项目时自动启动连接。 此选项默认已启用。

    撤销所有配对的会话

    移除所有已保存的批准。 之后,需要再次批准来自 Figma 的下一个连接。

2026年 11月 6日