#lib.autoExternal

• 类型：

type AutoExternal =
  | boolean
  | {
      dependencies?: boolean;
      optionalDependencies?: boolean;
      devDependencies?: boolean;
      peerDependencies?: boolean;
    };

• 默认值：
  • 当 format 为 cjs 或 esm 时为 true
  • 当 format 为 umd 或 mf 时为 false
• 命令行： --auto-external / --no-auto-external

是否自动对不同依赖类型的依赖进行外部化处理，不将其打包。

#对象类型

#autoExternal.dependencies

• 类型： boolean
• 默认值： true

是否自动外部化 dependencies 类型的依赖。

#autoExternal.optionalDependencies

• 类型： boolean
• 默认值： true

是否自动外部化 optionalDependencies 类型的依赖。

#autoExternal.peerDependencies

• 类型： boolean
• 默认值： true

是否自动外部化 peerDependencies 类型的依赖。

#autoExternal.devDependencies

• 类型： boolean
• 默认值： false

是否自动外部化 devDependencies 类型的依赖。

#默认值

autoExternal 的默认值为 true，意味着以下依赖类型不会被打包：

• dependencies
• optionalDependencies
• peerDependencies

而以下依赖类型会被打包：

• devDependencies

此配置等同于下面的对象类型：

export default {
  lib: [
    {
      format: 'esm',
      autoExternal: {
        dependencies: true,
        optionalDependencies: true,
        peerDependencies: true,
        devDependencies: false,
      },
    },
  ],
};

#示例

#自定义外部化的依赖类型

要禁用特定类型依赖的处理，你可以将 autoExternal 配置为一个对象，如下所示：

export default {
  lib: [
    {
      format: 'esm',
      autoExternal: {
        dependencies: false,
        peerDependencies: false,
      },
    },
  ],
};

#禁用默认行为

如果你想禁用默认行为，可以将 autoExternal 设置为 false：

export default {
  lib: [
    {
      format: 'esm',
      autoExternal: false,
    },
  ],
};

关于第三方依赖处理的更多细节，请参考 处理第三方依赖。