Figma插件需求：批量统计设计文件的组件、样式用量及库启用状态

一、Figma插件推荐 #

• Component Stats：在Figma内直接运行，可快速统计当前文件中所有组件（含共享库组件）的使用次数，能区分本地组件和库组件，同时支持颜色、文本样式的用量统计，支持导出CSV格式数据。
• Style Inventory：专注样式（颜色、文本、效果）统计，会列出每个样式在文件中的引用次数，还能标记未被使用的样式，方便清理冗余资源。

二、自动化批量处理方案（Figma API） #

如果需要批量处理多份文件，Figma API是更高效的选择，核心步骤如下：

1. 获取文件节点树：调用GET /v1/files/:file_key接口，获取文件内所有节点数据。
2. 遍历节点统计：编写脚本遍历每个节点，通过componentId字段识别组件使用情况，styleId字段识别样式使用情况，同时通过libraryItem字段确认是否来自启用的共享库。
3. 汇总数据：将统计结果整理为表格或JSON格式，自动记录每个文件的组件/样式用量、关联库的启用状态。

示例伪代码片段：

// 遍历节点统计组件使用量
function countComponents(nodes) {
  const componentCounts = {};
  nodes.forEach(node => {
    if (node.componentId) {
      const id = node.componentId;
      componentCounts[id] = (componentCounts[id] || 0) + 1;
      // 标记是否来自启用的共享库
      if (node.libraryItem?.status === 'ACTIVE') {
        componentCounts[`${id}_library_active`] = true;
      }
    }
    // 递归处理子节点
    if (node.children) {
      const childCounts = countComponents(node.children);
      Object.assign(componentCounts, childCounts);
    }
  });
  return componentCounts;
}

三、注意事项 #

• 插件仅能处理当前打开的单个文件，批量处理必须依赖Figma API。
• 使用API需要生成个人访问令牌，且需拥有目标文件的读取权限。
• 私有库的组件/样式统计需要对应库的访问权限，否则无法识别其来源。

内容的提问来源于stack exchange，提问作者Faisal Hanif