Rsbuild provides a debug mode to troubleshoot problems, you can add the DEBUG=rsbuild
environment variable when building to enable Rsbuild's debug mode.
In debug mode, Rsbuild will output some additional log information, and write the Rsbuild config and Rspack config to the dist directory, which is convenient for developers to view and debug.
In debug mode, you will see some additional information output from the terminal, among which are some process logs starting with debug
, indicating what operations are performed inside the Rsbuild.
In addition, the following logs will be output in the terminal, indicating that the Rsbuild has written the internally generated build configs to disk, and you can open these config files to view the corresponding content.
In debug mode, Rsbuild will automatically generate dist/rsbuild.config.mjs
file, which contains the final generated Rsbuild config. In this file, you can know the final result of the Rsbuild config you passed in after being processed by the framework and Rsbuild.
The structure of the file is as follows:
For a complete introduction to Rsbuild config, please see the Configure Rsbuild chapter.
Rsbuild will also automatically generate dist/rspack.config.web.mjs
file, which contains the final generated Rspack config. In this file, you can see what is included in the config that Rsbuild finally passes to Rspack.
The structure of the file is as follows:
For a complete introduction to Rspack configs, please see Rspack official documentation.