Advanced Settings

Use the ReSharper C++ language engine (CLion Nova)

Set this checkbox to switch to CLion Nova.

Use legacy generator for CMake 3.20 and higher

For CMake version 3.20 and higher, CLion uses CMake file API with Ninja generator by default. If you set this checkbox, the default generator will be Makefiles, and CLion will switch to CMake File API only if you specify a custom generator.

For older versions, CMake File API is used for the case of custom generator only regardless of this option's state. The default generator is Makefiles.

Do not trigger CMake reload automatically

Select this option to completely disable automatic reload of CMake projects including external changes. See Load/reload CMake.

Perform initial profile configuration when a project is opened for the first time

Clear this checkbox if you prefer CLion not to automatically configure and show a default CMake profile when you open a project for the first time.

Reload CMake profiles sequentially

Select this option if you want CLion to reload CMake profiles one after another. By default, CMake profiles are reloaded in parallel, but sometimes it may cause issues when reloading CMake. Use this option to resolve such issues.

Automatically import CMake Presets

By default, CLion automatically imports the detected configure and build presets into CMake profiles. Use the switcher to change this behavior:

• Configure and Build - the default option.

• Configure - only configure presets are imported.

• Build - only build presets are imported.

• None - presests import disabled. The existing presets-based profiles will be deleted upon the next CMake reload or project reopening.

Use floating toolbar to notify that CMake project needs to be reloaded

By default, when you make changes in CMakeLists.txt, CLion shows a floating notification indicating that the project needs to be reloaded. You can disable the floating notification by clearing this checkbox.

For more information, refer to Reload CMake on changes in CMakeLists.txt.

Use DAP protocol in CMake debugger

This option is enabled by default. For debugging in CMake version 3.27 and later, CLion uses the Debug Adapter Protocol (DAP).

Clear this checkbox to switch to the implementation based on the CMake script debugger from Sysprogs.

Pass Python interpreter to CMake

This option enables Python integration with CMake for all projects.

Enabled by default.

Use Clang-based indexer

Set this checkbox to enable Cland indexer for Find Usages.

Keep obsolete ASTs in clangd

With this option enabled, obsolete ASTs are not deleted immediately, which helps speed up navigation.

Download sources

By default, CLion doesn't download sources for the project dependencies on the initial project sync.

Select this option to change the project's behaviour and always download sources for dependencies during the importing process.

Open file as table if detected by scripted loader

For the files of formats supported by scripted data loaders. Defines which files CLion opens in a table view.

• All: All supported tabular data files.

• Table-first formats: Files of the file formats dedicated to representing data in a table format. Currently, all supported tabular data file formats, except JSON.

• None: Disables the view for all files.

Use old Import dialog

Enables the old UI of Import dialog instead of the current one.

Related Rows action behavior

Defines what the Related Rows action does when invoked in the table cell's floating toolbar or context menu.

• Navigate And Filter All: Shows only the referenced rows.

• Navigate And Select First: Shows all the rows in the corresponding table, and the first of the referenced rows is selected.

Show Database tab in Search Everywhere

Enables the Database tab in Search Everywhere (double Shift).

For more information about the Search everywhere feature, refer to Search everywhere.

Maximum number of recent expressions

Specify the number of expressions to be saved in history. This includes various fields like Evaluate expression and Goto address in disassembly/memory view.

Show inlay Run to Cursor popup

With this option enabled, you can hover over the line of code to which you wish to continue execution and then utilize the Run to Cursor popup to execute your code until it reaches the line where your cursor is placed.

Keep the process suspended after attaching

With this option enabled, the process you attach to will stay suspended.

Prepare GDB indexes for debug session

Set this checkbox if you experience performance issues with GDB.

With this option enabled, CLion prepares indexes for GDB before the debug session. On the first launch after enabling the option, only the executable is indexed. After that, CLion detects the loaded libraries and indexes them for subsequent debug sessions in addition to the executable. This means that the first debug session with indexes enabled might still be slow, but subsequent ones should be faster.

The option works on Linux machines for executables launched from the IDE.

Clone sources with --depth=1

Use this option to speed up your project cloning process by checking out the latest version of the source code. For more information, refer to Git documentation.

Connect to Docker automatically at restart

Connect to the configured Docker daemon after CLion starts.

Image registry entities loading limit

For performance reasons, by default, CLion shows only the first 100 images in a Docker registry. Increase this number if you need to list more. This will also increase the memory usage.

The log tab should be the first tab for the docker container

Show the Log tab as the first tab in the container overview pane.

The delay between periodic Docker status checks for automatic reconnection

How often should CLion check the status of connection to Docker in milliseconds.

Apply :z mount option to almost any bind volume for SELinux systems

Add :z configuration flags to Docker bind mounts to connect volumes to Docker containers on SELinux workstations.

Don't copy/cut the current line when invoking the Copy or Cut action with no selection

This option lets you override the default behavior of copying Ctrl+C or cutting Ctrl+X the whole current line when nothing is selected in the editor.

Don't select the copied line after invoking the Copy action with no selection

By default, when you use Ctrl+C without selecting anything, the whole line gets copied. With this action, you can avoid that selection.

When pasting a line copied with no selection

You can change the default Paste above the caret line behavior, and select either Paste at the caret line that restores the old Copy / Paste behavior or Trim if pasted middle line that will remove the unnecessary spaces before and after the copied line if it is pasted in the middle of the line.

Render special characters, such as control codes, using their Unicode name abbreviations

When this option is selected, you can use the Unicode name abbreviations for special characters, such as control codes.

Show zoom indicator

Use this option to see an indicator that shows the current font size and the option to revert it back to default while zooming your code in or out in the editor.

Tab character rendering

You can select one of the following options:

• Horizontal line

• > symbol

• Long arrow

Left margin in distraction free mode

This option lets you adjust the left editor margin in the distraction-free and zen viewing modes.

By default, the editor text in these viewing modes is centered vertically and the text column width corresponds to the Hard wrap at option on the Editor | Code Style page of settings  Ctrl+Alt+S. This means that if your code will be centered when formatted properly, but if there are long unwrapped lines, the text might go beyond the viewport while there is a large margin on the left. In such cases, you may want to decrease the left margin using this option.

Line number's font delta

Use this option to change the font size of the line numbers in the left gutter comparing to the font size in the editor.

Force soft wrap in documents with lines longer than n characters

The default number is 100000. Increasing this number might negatively affect the editor performance.

Select whitespace characters with 'Extend Selection'

Use this option to include whitespaces when you invoke the Extend Selection action.

Move caret down after Comment with Line Comment action

This option lets you configure whether to move the caret to the next line if you comment a line with a line comment Ctrl+/. Note that if there is a selection in the editor, the caret will not move regardless of this option.

Enable similar usages clustering in Find Usages view

CLion analyzes search results, detects the most common usage patterns, and categorizes all found usages into groups based on their structural similarity. These usage clusters appear in the Preview tab.

For more information, refer to Search for usages in a project.

Maximum number of results to show in Find in Files/Show Usages preview

The default maximum number of results is 100. Increasing this limit might significantly increase memory usage.

Maximum number of recent projects

Use this option to change the default number of stored recent projects, which is 50.

Maximum number of recent files

Use this option to change the default number of stored recent files, which is 50.

Maximum number of recent locations

Use this option to change the default number of stored recent locations, which is 25.

Duration of storing changes in Local History

Use this option to specify the number of days for which you want to keep changes in the local history.

Implicit Make output analyzer options

In this field, you can edit the Make output analyzer flags.

For example, if you remove the --just-print option, your project will be analyzed and built in a single pass. However, this can cause performance issues. Also, in this case the command output and Make output will be mixed, which can affect the analyzer accuracy.

Save Make output to log files...

Set this checkbox to collect the Make output logs.

Move focus to editor when Enter is pressed

When this option is selected, you can press Enter while in the Project view to switch focus to the editor.

When collapsing a node, also collapse all expanded nodes under it

When this option is selected, CLion collapses subnodes as well as the parent node.

When navigating to a library class, do not select it in the project tree

Do not automatically navigate to library files in the Project tool window even if the Always Select Opened File option is enabled.

You can navigate to library files in the tool window manually: use the Select Opened File button on the Project tool window toolbar or press Alt+F1 to open the Select In popup.

Increase font size in Project view

Select this option if you want to change the size of font in the Project view. You need to restart CLion.

Swap the order of actual and expected assertions in Pytest

By default, CLion provides the expected == actual pytest assertion. Select this checkbox to change the order of the assertion parameters to actual == expected.

Pytest: do not add "--no-header --no-summary -q

Use this checkbox to manage the test output generated by pytest. Select it to keep rendering the header and summary.

Temporary configurations limit

Use this option to change the default number of stored temporary run/debug configurations, which is 5.

Confirm rerun with process termination

When you call rerun for a running process, CLion prompts you to confirm the action of terminating the existing process and launching a new one. You can change the default behavior by clearing this checkbox.

Make configurations pinned by default

Select this option to automatically pin tabs that open in the Run tool window after you run configurations.

Generate configurations for new CMake/Makefile targets automatically

When you add new targets and reload your CMake or Makefile project, CLion automatically creates the corresponding CMake Application or Native Application configurations.

Delete configurations for missing CMake/Makefile targets automatically

When you delete targets and reload your CMake or Makefile project, CLion automatically deletes the corresponding CMake Application or Native Application configurations.

Maximum number of recent run configurations in the new UI

Specify the number of recent run/debug configurations that will be displayed in the Run widget.

Keep last selected search scope

Select this option to quickly look up the history of the search scope.

Open README.md file if there are no open files on project startup

If you select this option, CLion will open a README.md file if there aren't any opened files when you start your project.

Always show tool window header icons

By default, the icons in tool window headers (for example, and ) are displayed only when you hover over a tool window or when a tool window is in focus.

Enable the option to display tool window header icons all the time.

Allow dragging tool windows by header to move to another location

Move tool windows by dragging the header.

When the option is disabled, you can move tool windows by dragging tool window bars, using the Move to context menu option or the tool window settings located under the / icon.

Show file type icon in IDE frame header

On macOS, the icon can be used to drag a file to a different application.

Use words instead of symbols for macOS keyboard shortcuts

Select this option if you want to see shortcuts with words instead of symbols.

Cyclic scrolling in lists and trees

Select the last element when pressing Up on the first element, and vice versa.

Position mouse cursor on default button in dialogs

When this option is selected, the mouse pointer is placed on the default button (usually it is OK) in a dialog.

Disable double modifier key shortcuts

You can disable shortcuts where a double key is used. For example, Shift or Ctrl.

Open Diff as Editor Tab

When this option is selected, the Diff Viewer is displayed as the editor tab.

Load file annotations from VCS when file is opened in editor

When this option is selected, CLion loads annotations when you open a file in the editor.

Highlight ignored files

When this option is selected, CLion shows the list of ignored files from VCS and displays their status in the editor.

Enable Commit tool window

When you select this option, CLion displays the Local Changes and Shelf tabs in a separate tool window.

Toggle commit controls

When this option is selected, CLion hides the commit panel and checkboxes after the commit is performed and lets you toggle them in the Commit Changes dialog.

Select all repositories with new commits for push

When this option is selected, CLion selects all commits that will be pushed by default.

Recursively clone submodules in the project

When this option is selected, during the checkout from Git, git clone --recurse-submodules is used that clones the main repository with all available submodules.

Apply content transformation when reading from Git

When this option is selected, CLion will use the --filters or --textconv flags for the git cat-file command when reading the file content from Git.

Use Safe Force Push

When this option is selected, CLion uses --force-with-lease when force push is called from the IDE instead of just --force.

Check for incoming and outgoing commits

When this option is selected, CLion updates the information on the branches that have incoming or outgoing commits in the Branches popup.

Use Windows certificate store

When this option is selected, it forces Git to use Windows certificate store to verify SSL connections. This works for Git 2.14 and later versions.

Execute commands in login (-l) shell

With this option enabled, CLion executes WSL commands in login shell. This is helpful when you need to source environment variables from files like .bashrc or .profile.