本文详解 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 数组是最终执行清单——所有需要运行的插件，无论是否属于预设，都必须在此数组中显式存在。 掌握这一原则，即可高效定制优化流程。
