Compile files without build
Build | Recompile
To speed up the development process, you may sometimes prefer to compile one file without building the whole project. For this purpose, CLion provides the Recompile action.
Recompile is available for individual source and header files, and also for groups of files selected in the project tree. For headers, CLion uses resolve context to compile one of the source files that include the specified header). Note that Recompile is disabled for directories and non-C/C++ files.
tip
You can use Recompile for CMake, Makefile, Meson, and compilation database projects.
Use of the following options:
For the currently opened file, select Build | Recompile from the main menu or press CtrlShiftF9:
For a file in the project tree, select Recompile from the context menu (or use the same CtrlShiftF9 shortcut):
For several files, select them in the project tree, and use the Recompile Selected Files option from the context menu CtrlShiftF9:
note
When used for multiple files, recompilation stops upon the first compilation failure.
When called from a Makefile or a compilation database project, Recompile takes the compilation command found during project analysis, modifies it (skipping the output and adding the --syntax-only
flag), and uses it to compile the selected file.
note
The details described below are applicable if you are using the default CMake generator in the following cases:
your CMake version is 3.19 or earlier
or you have set the Use legacy generator for CMake 3.20 and higher checkbox in Settings | Advanced Settings
When you use Recompile, a CMake target is called instead of a direct compiler call. The target to call is picked based on the list of the available run/debug configurations:
If the file to compile belongs to the currently selected configuration, then the build target from this configuration is used.
Otherwise, CLion attempts to find a suitable configuration, prioritizing those with the same CMake profile as the currently selected one.
If the previous step has failed, then CLion reports an error.
Similarly to regular builds, you can examine the results of a single file compilation in the Message Tool Window:
![Recompilation successful Recompilation successful](https://resources.jetbrains.com/help/img/idea/2024.3/cl_recompile_success.png)
If the compilation fails, you will get a signaling popup message:
![Recompilation failed Recompilation failed](https://resources.jetbrains.com/help/img/idea/2024.3/cl_recompile_fail.png)
Thanks for your feedback!