SVG 图标集打包与前端集成验收

把图标清单视为界面交付约定

这个流程面向需要交付可复用界面图标集的前端开发者。每个图标保留一份已批准的独立 SVG，记录用途与实际小尺寸。用 svg-minifier-analyzer 检查源稿并比较优化前后的外观。合并前处理缺失 viewBox：由宽高推导的矩形不一定覆盖偏移的绘图。渐变、蒙版和裁剪路径也要进入清单。浏览器标签图标与应用清单有另一套交付要求，可转到 svg-favicon-icon-workflows。

合并时保留身份与颜色意图

使用 svg-sprite-generator 合并最多 30 个文件，选定前缀后记录生成 ID，不要假设源文件名原样保留。去重依据 viewBox 与折叠空白后的内容，移除重复项后要更新消费端引用。顶层 ID 不重名不能保证内部渐变或裁剪 ID 已隔离，仍须检查整套图标的引用。多色图保留原色；单色图剥离颜色后，重新核对空心形状，并在消费端明确填充或描边。移除 fill=none 可能让原本空心的区域变实心。

以集成页面作为验收依据

symbol 模式应在页面插入一次下载的图标集，再引用真实生成的符号 ID。外部模式应部署到最终资源路径，并确认消费端引用的是实际输出的片段或分组。使用片段只是起点，每个图标都要实测，包括清单末项；独立预览正确不能证明上线引用正确。检查亮暗背景、激活状态与目标尺寸。工具删除脚本和事件属性，但不能据此宣称任意 SVG 已全面净化，应采用经过审核的源稿。仅图标控件需要有意义的可访问名称，装饰图标另按用途处理。

从正确源稿交付位图回退

目标环境需要位图时，将每个独立源稿交给 svg-to-png 或 svg-to-webp，不要把隐藏的符号集合当作联系表转换。核对实际像素尺寸、透明通道和小尺寸清晰度，然后一起交付图标集、源文件到 ID 的映射、必需回退文件与集成测试记录。样式覆盖异常交给 css-authoring-layout-and-cascade-workflows，完整页面无障碍审查继续使用 web-accessibility-audits。