#命令行工具

Rslib 内置了一个轻量级的命令行工具，包含 rslib build、rslib inspect 等命令。

#查看所有命令

如果你需要查看所有可用的 CLI 命令，请在项目目录中运行以下命令：

npx rslib -h

输出如下：

Usage:
  $ rslib <command> [options]

Commands:
  build    构建用于生产环境的产物
  inspect  检查 Rslib 项目的 Rsbuild 配置和 Rspack 配置
  mf-dev   为 Module Federation 格式的库启用 Rsbuild 开发服务器

#公共选项

Rslib CLI 提供了一些公共选项，可以用于所有命令：

#rslib build

rslib build 命令默认会在 dist/ 目录下输出构建产物。

Usage:
  $ rslib build

Options:
  -w --watch            开启 watch 模式, 监听文件变更并重新构建

#环境变量

Rslib 支持在构建过程中向代码中注入环境变量或表达式，这对于区分运行环境、替换常量值等场景很有帮助。你可以查看 Rsbuild - 环境变量 了解更多详细信息。

默认情况下，Rslib 会自动设置 process.env.NODE_ENV 环境变量，在 build 时始终为 'production'。如果你需要区分 watch 模式来动态写入不同的配置，可以如下：

import { defineConfig } from '@rslib/core';

const isWatch = process.argv.includes('--watch');

export default defineConfig({
  lib: [
    {
      format: 'esm',
    },
  ],
  source: {
    alias: {
      '@request': isWatch ? './src/request.dev.js' : './src/request.prod.js',
    },
  },
});

#rslib inspect

rslib inspect 命令用于查看 Rslib 项目的 Rsbuild 配置和 Rspack 配置。

Usage:
  $ rslib inspect

Options:
  --output <output>     指定检查内容输出路径（默认：".rsbuild"）
  --verbose             在输出中显示完整的函数定义

当你在项目根目录下执行命令 npx rsbuild inspect 后，会在项目的 dist/.rsbuild 目录生成以下文件：

• rsbuild.config.mjs: 表示在构建时使用的 Rsbuild 配置。
• rspack.config.web.mjs: 表示在构建时使用的 Rspack 配置。
• rslib.config.mjs: 表示归一化后的 Rslib 配置。

➜ npx rslib inspect

Inspect config succeed, open following files to view the content:

  - Rsbuild Config: /project/dist/.rsbuild/rsbuild.config.mjs
  - Rspack Config (esm): /project/dist/.rsbuild/rspack.config.esm.mjs
  - Rslib Config: /project/dist/.rsbuild/rslib.config.mjs

#完整内容

默认情况下，inspect 命令会省略配置对象中的函数内容，你可以添加 --verbose 选项来输出函数的完整内容：

rslib inspect --verbose

#多种输出格式

如果当前项目同时有多种输出格式，比如 ESM 产物和 CJS 产物，那么会在 dist/.rsbuild 目录生成多份 Rspack 配置文件。

➜ npx rslib inspect

Inspect config succeed, open following files to view the content:

  - Rsbuild Config (esm): /project/dist/.rsbuild/rsbuild.config.esm.mjs
  - Rsbuild Config (cjs): /project/dist/.rsbuild/rsbuild.config.cjs.mjs
  - Rspack Config (esm): /project/dist/.rsbuild/rspack.config.esm.mjs
  - Rspack Config (cjs): /project/dist/.rsbuild/rspack.config.cjs.mjs
  - Rslib Config: /project/dist/.rsbuild/rslib.config.mjs

#rslib mf-dev

rslib mf-dev 命令用于为 Module Federation 格式的库启用 Rsbuild 开发服务器。

这允许你在 host 应用中访问和调试 mf 格式的模块。