Makefile projects
Full support for Makefile projects in CLion is still a work in progress. Use the tickets linked to CPP-494 to leave your feedback and vote for the desired features.
Open a Makefile project
Select
from the main menu.Point CLion to the folder that contains the top-level Makefile.
You will be prompted to clean the project:
Cleaning is required for the project load as the Make build is incremental and only the updated files are compiled. When run on an uncleaned project, reload will miss all the unchanged files and might perform incorrectly.
Clear the Clean project checkbox if you prefer to load without cleaning. You will be able to clean and reload your project later (for example, after performing the required bootstrapping).
CLion starts loading the project, displaying the progress and status in the Build tool window:
Warning messages may appear during the process, but if loading finishes with a green checkmark
next to the project name, this indicates a successful load. Take a look at the Troubleshooting section if your project fails to load correctly.
Load a Makefile for an opened project
You can also open a project as a folder and load the Makefile later. This is helpful, for example, if your project requires some preconfigure step or launching a script to prepare the final Makefile, so you don't have it when opening your project in CLion.
To load the Makefile when ready, open it in the editor and click the Load Makefile project link in the notification:
![Load Makefile project notification Load Makefile project notification](https://resources.jetbrains.com/help/img/idea/2024.2/cl_makefile_load_notification.png)
Alternatively, use the Load Makefile Project action from the file's context menu in the project tree.
Configure auto-reload
By default, CLion doesn't update or reload your project automatically except for the cases of external events like VCS update. You can change this behavior in the Build Tools settings.
Go to
.Select one of the auto-reload options:
Any changes - project reload will be triggered on any change in Makefiles.
External changes (default) - your project will be reloaded only upon external events like VCS update. In case of other changes (for example, when you add a new file), you will get a notification on the Makefile:
Reload manually
Apart from the automatic options, you can also reload your project manually:
Call
or from in the main menu.Alternatively, click
or
in the Build tool window:
Adjust the project settings
Use the
dialog to control your project settings.![Makefile settings Makefile settings](https://resources.jetbrains.com/help/img/idea/2024.2/cl_makefile_settings.png)
Toolchain
Here you can select the toolchain to be used for loading your Makefile project.
Note that NMake is not supported currently, so you can't use the Visual Studio toolchain directly. In order to work with it, you need to build the project separately using GNU Make.
If the toolchain you selected includes non-default compilers (configured explicitly in the C Compiler and C++ Compiler fields), they will be passed to
make
as well.Build options
In this field, you can provide additional make options for the project build. These options don't affect the project reload.
Commands
In this field, you can adjust preconfiguration parameters. See Pre-configuration (GNU Autoconf).
Arguments
These arguments are used by CLion when calling the
make
command on the step of extracting project information, cleaning the project, or searching for build targets.Build target and Clean target
These targets are used along the
make
command to extract the project information. If you leave the Build target field empty, CLion will take the first target specified in the project’s top Makefile.Also, the targets specified here are used when you call Build Project or Rebuild Project from the Build actions menu.
You can quickly access the Makefile settings dialog from the Build tool window. Select Makefile Settings from the context menu or click :
![Accessing Makefile settings from the Build tool window Accessing Makefile settings from the Build tool window](https://resources.jetbrains.com/help/img/idea/2024.2/cl_makefile_settings_fromtw.png)
Advanced settings
More settings for Makefile projects are available in
:![Advanced settings for Makefile projects Advanced settings for Makefile projects](https://resources.jetbrains.com/help/img/idea/2024.2/cl_makefile_advancedsettings.png)
Run/debug Makefile applications
CLion automatically creates a Native Application configuration for each target from the top-level Makefile:
![Auto-created Native Application configurations Auto-created Native Application configurations](https://resources.jetbrains.com/help/img/idea/2024.2/cl_makefile_targetconfigs_autocreated.png)
When creating configurations, CLion filters out the following targets:
The
clean
target.Targets that correspond to object (.o) files.
Targets that end with unknown file extensions (for example, .d).
You can customize the automatically created configurations or create new ones in the
dialog (see below).Create a Native Application configuration
In the main menu, go to
, click, and select Native Application from the list of templates:
In the Target field, you can choose one of the detected targets:
Another option is to set a custom build target with type Make. Click
next to the Target field, add (
) a new Make target, and fill in the parameters:
In the Executable field, provide the full path to the binary.
To run/debug remotely, provide the path to the binary on your remote machine. Note that remote path needs to be set manually.
Other settings of the Native Application template are described on the reference page.
Run a Native Application configuration
Select the desired configuration in the switcher and then use one of the following options:
Click
.
Press Shift+F10.
Select
from the main menu.
Debug a Native Application configuration
Before you start a debug session, make sure the binary specified in the configuration includes debug symbols.
Select the desired configuration in the switcher and then use one of the following options:
Click
on the toolbar.
Press Shift+F9.
Select
from the main menu.
Run Makefile targets
You can use the gutter menu to quickly call make
for a particular target:
![Gutter menu for running targets Gutter menu for running targets](https://resources.jetbrains.com/help/img/idea/2024.2/cl_makefiles_gutter.png)
Alternatively, you can run targets from the Make tool window ( ). Double-click a target or select it and then click :
![Running targets from the make tool window Running targets from the make tool window](https://resources.jetbrains.com/help/img/idea/2024.2/cl_make_tool_window.png)
Upon any of these actions, CLion creates a temporary configuration of the Makefile Target type. You can customize it or create new configurations out of the same template in the dialog (see below).
Create a Makefile Target configuration
In the main menu, go to
, click, and select Makefile Target from the list of templates:
In the settings, you can set up several targets to run, provide additional arguments, and tune other parameters if required. For more information, refer to the reference page.
Click Apply to save the changes.
WSL specifics
Sync the settings
When working with WSL, make sure to sync the per-project toolchain settings and the global Make settings:
Go to
.Click the selector next to Path to Make executable and set the path to WSL's
make
:
Non-root WSL user
If you are working under a non-root WSL user, this user should be set as default in order to own the make
process and all the files it may create.
Create a /etc/wsl.conf file inside your WSL guest and add the following lines:
[user] default=usernameHere,
username
is the WSL guest username (which may be different from the Windows username).Find out more in WSL documentation.
Restart the WSL machine.
Troubleshooting
Make sure that both Makefile and Makefile Language plugins are enabled. Check the Installed tab in .
![Makefile support plugins Makefile support plugins](https://resources.jetbrains.com/help/img/idea/2024.2/cl_makefile_plugins.png)
If your project fails to load correctly, try the following tips:
Check Makefile settings:
Make sure to select a proper toolchain. Your project should build successfully in the selected environment.
Arguments and Build target may need adjustments for the case of your project.
Call
from the main menu or clickin the Build tool window.
If your project's Makefiles were generated by Premake, try removing the
--no-print-directory
arguments from the root Makefile.In case none of the above helps, try cleaning the project cache from /makefiles in the system directory (for example, ~/Library/Caches/JetBrains/CLion2020.2/makefiles/postgrtipes.dc29ef09), then reload the project.
Current limitations and future plans
CLion handles Makefile projects that use wrappers like ccache and libtool (as well as its alternative implementations like Dolt, slibtool, and jlibtool), but distcc is not yet supported (CPP-19305).
Non-GNU Makes like NMake or BSD Make are not supported at the moment (CPP-18723).
Unit testing configurations are not available for Makefile projects yet (CPP-20718).