.. _clion:

CLion
#####

:link_to_translation:`zh_CN:[中文]`

What Is CLion?
~~~~~~~~~~~~~~

`CLion <https://www.jetbrains.com/clion/>`__ is a cross-platform integrated development environment (IDE) for C and C++ programming. It provides dedicated support for ESP-IDF, allowing developers to work seamlessly with the ESP-IDF framework.

Starting with v2025.1.1, `CLion is available at no cost <https://blog.jetbrains.com/clion/2025/05/clion-is-now-free-for-non-commercial-use/>`__ if you’re using it to contribute to open-source projects, learn or teach C/C++, develop an application for personal use, or work on other non-commercial projects.

Installation
~~~~~~~~~~~~

You can download CLion:

- as a `standalone version <https://www.jetbrains.com/clion/download/>`__, via `Toolbox App <https://www.jetbrains.com/toolbox-app/>`__.
- or as a snap package if you’re using Ubuntu.

To learn about the required toolchains, check this `documentation <https://www.jetbrains.com/help/clion/installation-guide.html#toolchain-reqs>`__.

Configuration
~~~~~~~~~~~~~

To configure an ESP-IDF project in CLion, follow the `Working with ESP-IDF in CLion <https://developer.espressif.com/blog/clion/#configuring-an-esp-idf-project>`__ tutorial. It provides detailed instructions on how to configure a project, build an application, flash it to a board, and debug it. You can also refer to `CLion's ESP-IDF documentation <https://www.jetbrains.com/help/clion/esp-idf.html>`__.

Resources
~~~~~~~~~

For more information about the features and integrations CLion provides for embedded developers, refer to the following resources:

- `Embedded development support <https://www.jetbrains.com/help/clion/embedded-overview.html>`__: An overview of how you can use CLion as your embedded development IDE.
- `Debug servers <https://www.jetbrains.com/help/clion/debug-servers.html>`__: A new feature that provides a convenient way to configure and use a debug server with various build targets, including those for ESP-IDF.
- `PlatformIO integration <https://www.jetbrains.com/help/clion/platformio.html>`__: A detailed guide on how to work with the PlatformIO framework, using the `PlatformIO for CLion <https://plugins.jetbrains.com/plugin/13922-platformio-for-clion>`__ plugin.