SVGO v3 自定义配置：正确启用 removeXMLNS 等插件的完整指南

本文详解 svgo v3 中如何通过配置文件正确覆盖默认插件行为，重点解决 removexmlns 无法生效的问题，涵盖 preset-default 覆盖语法、独立插件追加方式及 cli 配置验证要点。

本文详解 svgo v3 中如何通过配置文件正确覆盖默认插件行为，重点解决 removexmlns 无法生效的问题，涵盖 preset-default 覆盖语法、独立插件追加方式及 cli 配置验证要点。

在 svgO v3 中，插件配置机制发生了重要演进：preset-default 不再自动包含所有默认插件，其 overrides 仅用于调整内置插件参数，而新增或启用禁用状态的插件（如 removeXMLNS）必须显式声明在 plugins 数组中，且需置于 preset-default 之后。这是导致许多用户配置失效的根本原因。

✅ 正确配置结构（v3 推荐写法）

以下是一个功能完备、经验证的 svgo.config.js 示例，支持：

• 调整 inlineStyles 参数；
• 禁用 removeDoctype；
• 启用 removeXMLNS（注意拼写：removeXMLNS，非 removeXLMNS）；
• 同时添加其他插件（如 addClassesToSVGElement）：

// svgo.config.js module.exports = {   plugins: [     // 第一步：加载并定制默认预设     {       name: 'preset-default',       params: {         overrides: {           inlineStyles: {             onlyMatchedOnce: false,           },           removeDoctype: false, // 禁用该插件         },       },     },     // 第二步：显式追加额外插件（顺序关键！）     'removeXMLNS', // ✅ 启用：移除 xmlns 属性     {       name: 'addClassesToSVGElement',       params: {         className: 'mySvg',       },     },   ], };

⚠️ 关键注意事项：

• 拼写必须精确：removeXMLNS（X、M、L、N、S 大小写敏感），原文中的 removeXLMNS 是典型拼写错误；
• 位置不可错位：自定义插件（如 ‘removeXMLNS’）必须写在 preset-default 对象之后，否则会被预设覆盖或忽略；
• overrides 仅限参数调整：它不能“启用”被预设默认禁用的插件，只能修改已启用插件的行为；
• CLI 调用需指定路径：确保使用绝对路径或相对路径正确引用配置文件：

  svgo --config ~/Scripts/svg/svgo-optimise.js input.svg -o output.svg

? 验证配置是否生效

运行带 –verbose 的命令可查看实际加载的插件链：

svgo --config ./svgo.config.js --verbose input.svg

输出中应明确列出 removeXMLNS 插件，并在处理日志中显示其执行过程（如 removeXMLNS: removed xmlns Attribute）。

? 补充说明：为什么旧文档容易误导？

SVGO v2 及更早版本中，removeXMLNS 曾是 preset-default 的默认启用插件；而 v3 将其设为默认禁用，以提升兼容性（避免破坏依赖 xmlns 的 SVG 渲染）。因此，任何依赖“旧版默认行为”的配置在 v3 下均需显式声明。

总结而言，SVGO v3 的配置逻辑更清晰也更严格：preset-default 是基础模板，plugins 数组是最终执行清单——所有需要运行的插件，无论是否属于预设，都必须在此数组中显式存在。 掌握这一原则，即可高效定制优化流程。