#tools.svgr

• 类型： Object | Function | false
• 默认值：

const defaultOptions = {
  mixedImport: true,
  svgrOptions: {
    exportType: 'named',
  },
};

tools.svgr 用于修改 @rsbuild/plugin-svgr 的选项，取值为该插件的完整选项。设置为 false 时不再注册 SVGR 插件，所有 .svg 文件按静态资源处理。

#合并规则

tools.svgr 为 Object 类型时，顶层字段与默认配置通过 Object.assign 进行浅层合并，svgrOptions 会再合并一层，因此只设置 svgrOptions.icon 不会丢掉默认的 exportType。

tools.svgr 为 Function 类型时，默认配置作为第一个参数传入，可以直接修改配置对象，也可以返回一个值作为最终结果。也支持传入由对象和函数组成的数组，按顺序依次应用。

#并行转换

SVGR 转换是纯 JavaScript 计算，默认只占用 Node.js 主线程。项目里 SVG 文件较多时，开启 parallel 可以把转换分发到 worker 线程池：

export default {
  tools: {
    svgr: {
      parallel: true,
    },
  },
};

#修改默认导出

svgrOptions.exportType 决定 SVG 文件默认导出的内容：'named' 表示默认导出是文件 URL，React 组件通过 ReactComponent 具名导出；'default' 表示默认导出就是 React 组件。

export default {
  tools: {
    svgr: {
      svgrOptions: {
        exportType: 'default',
      },
    },
  },
};

#关闭 SVGR

如果你确定项目内的所有 SVG 资源都没有当成 React 组件使用，可以关闭 SVGR 以提升构建性能：

export default {
  tools: {
    svgr: false,
  },
};

#与旧配置的关系

tools.svgr 取代了下面两个已废弃的配置项，二者目前仍然生效，并将在下一个大版本中移除：

同时设置时以 tools.svgr 为准：显式设置了 tools.svgr 后，output.disableSvgr 不再生效；tools.svgr.svgrOptions.exportType 会覆盖 output.svgDefaultExport 派生的值。