For AI agents: the complete documentation index is available at https://rsbuild.rs/zh/llms.txt, the full documentation bundle is available at https://rsbuild.rs/zh/llms-full.txt, and this page is available as Markdown at https://rsbuild.rs/zh/config/resolve/condition-names.md.
close
  • 简体中文
  • resolve.conditionNames

    指定用于匹配包 exports 字段 入口点的 condition names(条件名称)。

    示例

    resolve.conditionNames 配置的值会覆盖 Rsbuild 的默认值:

    rsbuild.config.ts
    export default {
      resolve: {
        conditionNames: ['require', 'node'],
      },
    };

    Rspack 配置

    resolve.conditionNames 是 Rspack 提供的配置,参考 Rspack - resolve.conditionNames。

    事实上,你也可以使用 tools.rspack 来配置它:

    rsbuild.config.ts
    export default {
      tools: {
        rspack: {
          resolve: {
            conditionNames: ['custom'],
          },
        },
      },
    };

    这两种用法的区别在于配置合并的方式。

    resolve.conditionNames 在合并 Rsbuild 配置时覆盖已有数组,而 tools.rspack.resolve.conditionNames 会合并显式配置的值,不包含 Rspack 在后续初始化时应用的默认值。