fix: verbose Rslib normalized config only in Rslib debug mode

Author: Timeless0911

packages/core/src/cli/initConfig.ts

@@ -12,6 +12,15 @@ import { logger } from '../utils/logger';
 import type { BuildOptions, CommonOptions } from './commands';
 import { onBeforeRestart } from './restart';
 
+const shouldPrintSerializedRslibConfig = (): boolean => {
+  if (!process.env.DEBUG) {
+    return false;
+  }
+
+  const values = process.env.DEBUG.toLocaleLowerCase().split(',');
+  return ['rslib'].some((key) => values.includes(key));
+};
+
 const getEnvDir = (cwd: string, envDir?: string) => {
   if (envDir) {
     return path.isAbsolute(envDir) ? envDir : path.resolve(cwd, envDir);
@@ -141,8 +150,11 @@ export async function initConfig(options: CommonOptions): Promise<{
 
   applyCliOptions(config, options, root);
 
-  logger.debug('Rslib config used to generate Rsbuild environments:');
-  logger.debug(`\n${util.inspect(config, { depth: null, colors: true })}`);
+  // only debug serialized rslib config when DEBUG=rslib
+  if (shouldPrintSerializedRslibConfig()) {
+    logger.debug('Rslib config used to generate Rsbuild environments:');
+    logger.debug(`\n${util.inspect(config, { depth: null, colors: true })}`);
+  }
 
   return {
     config,

website/docs/en/guide/basic/configure-rslib.mdx

@@ -228,5 +228,5 @@ Inspect config succeed, open following files to view the content:
 - Open the generated `/dist/.rsbuild/rspack.config.esm.mjs` file to see the complete content of the Rspack config.
 
 ::: info
-If you want to view the normalized Rslib configuration, you need to run [rslib inspect](/guide/basic/cli#rslib-inspect) command.
+If you want to view the normalized Rslib configuration, you can add the `DEBUG=rslib` environment variable when building or run the [rslib inspect](/guide/basic/cli#rslib-inspect) command.
 :::

website/docs/zh/guide/basic/configure-rslib.mdx

@@ -228,5 +228,5 @@ Inspect config succeed, open following files to view the content:
 - 打开生成的 `/dist/.rsbuild/rspack.config.esm.mjs` 文件，即可查看 Rspack 配置的完整内容。
 
 ::: info
-如果你想查看归一化后的 Rslib 配置，需要运行 [rslib inspect](/guide/basic/cli#rslib-inspect) 命令。
+如果你想查看归一化后的 Rslib 配置，可以在执行构建时添加 `DEBUG=rslib` 环境变量或运行 [rslib inspect](/guide/basic/cli#rslib-inspect) 命令。
 :::