close
logo
Rslib
指南
配置
博客
English
简体中文
指南
配置
博客
English
简体中文
logo
Rslib
配置总览

Lib 配置

lib.format
lib.bundle
lib.autoExtension
lib.autoExternal
lib.redirect
lib.syntax
lib.externalHelpers
lib.banner
lib.footer
lib.dts
lib.shims
lib.id
lib.umdName
lib.outBase

Rsbuild 配置

logLevel
resolve
source
output
tools
plugins
📝 在 GitHub 上编辑此页
上一页lib.umdName
下一页Rsbuild 配置

#lib.outBase

  • 类型: string
  • 默认值: undefined
INFO

outBase 是 bundleless 模式 的特定配置。该配置在 bundle 模式下不会生效,因为所有产物文件都被打包成一个文件,不需要再确定基础输出目录。

在使用 bundleless 模式构建源文件存在于多个目录的项目时,输出目录结构将相对于 outBase 目录复制到输出目录中。如果未指定基础输出目录,则默认使用所有入口文件路径的 最近公共祖先。

配置 outBase 将改变基础输出目录的路径,outBase 可以是相对于当前进程目录的相对路径或绝对路径。

举个例子,我们有以下目录结构:

.
├── package.json
├── rslib.config.ts
└── src
    └── utils
        ├── bar
        │   └── index.ts
        ├── foo
        │   └── index.ts
        └── index.ts

如果未指定基础输出目录,则默认使用所有输入入口文件路径的最近公共祖先目录,即 ./src/utils,最终的文件输出结构为:

dist
├── bar
│   └── index.js
├── foo
│   └── index.js
└── index.js

当配置了 outBase 为 ./src 时,输出目录结构为:

dist
└── utils
    ├── bar
    │   └── index.js
    ├── foo
    │   └── index.js
    └── index.js
TIP

当项目需要生成类型声明文件时,为了保证生成的类型声明文件与 JS 文件保持一致的输出目录结构,如果修改了 outBase 配置,需要确保 tsconfig.json 中的 rootDir 为相同的路径。