close
  • 简体中文
  • 总览

    • 类型:
    interface LibConfig extends EnvironmentConfig {
      autoExtension?: boolean;
      autoExternal?: AutoExternal;
      banner?: BannerAndFooter;
      bundle?: boolean;
      dts?: Dts;
      experiments?: { exe?: ExeOptions };
      externalHelpers?: boolean;
      format?: Format;
      id?: string;
      outBase?: string;
      footer?: BannerAndFooter;
      redirect?: Redirect;
      shims?: Shims;
      syntax?: Syntax;
      umdName?: Rspack.LibraryName;
    }
    
    type SharedLibConfig = Pick<
      LibConfig,
      | 'bundle'
      | 'autoExtension'
      | 'autoExternal'
      | 'redirect'
      | 'syntax'
      | 'externalHelpers'
      | 'banner'
      | 'footer'
      | 'shims'
      | 'outBase'
    >;
    
    interface RslibConfig extends RsbuildConfig, SharedLibConfig {
      lib: LibConfig[];
    }
    • 默认值: undefined

    • 必选: true

    lib 配置是一个对象数组,每个对象代表一组不同的配置。这些配置包括所有 Rsbuild 配置以及 Rslib 特定的配置,可以生成不同格式的产物。

    共享的 lib 配置

    部分 lib 配置也可以配置在 RslibConfig 顶层,作为所有 lib 项的默认值。lib 项内的同名配置会覆盖顶层配置。

    以下配置支持顶层配置:

    配置项说明
    bundle是否打包库。
    autoExtension是否自动设置 JavaScript 产物文件扩展名。
    autoExternal是否自动外部化依赖。
    redirect配置产物文件中导入路径的重定向。
    syntax配置 JavaScript 和 CSS 的语法目标。
    externalHelpers是否从 @swc/helpers 导入 SWC 辅助函数。
    banner在产物文件顶部注入内容。
    footer在产物文件底部注入内容。
    shims配置 CommonJS 和 ESM 产物的 shims。
    outBase配置 bundleless 产物文件的基础目录。