# ESP-IDF

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **Note:**
> この記事は近日中に更新されます。 それまでの間、IDE で ESP-IDF プロジェクトを操作するための現在のアプローチを説明した [CLion で ESP-IDF を操作する(英語)](https://developer.espressif.com/blog/clion/)チュートリアルを参照してください。 このチュートリアルでは、プロジェクトの設定、アプリケーションのビルド、ボードへの書き込み、デバッグの詳細な手順が説明されています。

[ESP-IDF(英語)](https://github.com/espressif/esp-idf) は、 [ESP32 および ESP32-S シリーズ SoC(英語)](https://www.espressif.com/en/products/socs) の公式開発フレームワークです。 この記事は、CLion で ESP-IDF を操作するための入門ガイドです。

いくつかの手順は、 [ESP-IDF はじめ(英語)](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html#step-2-get-esp-idf)にガイドを複製します。 以下の例は macOS の場合について与えられており、それに応じて Windows 固有の指示がマークされています。

Procedure: 環境を整える

1. システムに最新の [Python(英語)](https://www.python.org/downloads/) バージョン、 [pip(英語)](https://packaging.python.org/tutorials/installing-packages/)、および [git(英語)](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) がインストールされていることを確認してください。

2. システムターミナルを使用して、ESP-IDF のディレクトリを作成し、公式 [リポジトリ(英語)](https://github.com/espressif/esp-idf)のクローンを作成します。

```CONSOLE
mkdir -p ~/esp
cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git

```

ESP-IDF は  `~/esp/esp-idf`  にダウンロードされます。

3. 同じシェルに、ツールをインストールします。

```CONSOLE
cd esp-idf
./install.sh

```

4. Windows では、ESP-32 ボードの USB ブリッジが正しく識別されていることを確認してください。   デバイスマネージャー   で確認できます。

> **Tip:**
> ビデオの説明については、 [Windows 上の CLion を使用した ESP32 用の開発: 準備(英語)](https://www.youtube.com/watch?v=M6fa7tzZdLw&t=21s)を参照してください。

Procedure: CLion のターミナルを使用してサンプルプロジェクトを設定する

1. CLion で、メインメニューの  `ファイル | オープン`  に移動し、  `~/esp/esp-idf`  ディレクトリを選択します。

この時点で、  現在のディレクトリ '../esp/esp-idf' はビルドできません ...  エラーが原因でプロジェクトのロードが失敗する可能性があります。

2. CLion の内蔵ターミナル（  `表示 | ツールウィンドウ | ターミナル`  または `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)) ）を開きます。

3. `. $HOME/esp/esp-idf/export.sh`  を実行して環境変数を設定します。

![ESP-IDF 環境を設定した結果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_espidf_environment.png)

4. `examples/get-started`  ディレクトリから   hello_world   プロジェクトを構成しましょう。 次のコマンドは、ESP32 チップをターゲットとして設定し、  menuconfig  構成ユーティリティを実行します。

```CONSOLE
cd $IDF_PATH/examples/get-started/hello_world
idf.py set-target esp32
idf.py menuconfig

```

最後のコマンドは、構成メニューを開きます。 使用している   hello_world   プロジェクトはデフォルト構成で実行されるため、このメニューで設定する必要はありません。

![設定メニュー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_espidf_configmenu.png)

メニューから出て、構成が完了していることを確認します。

5. これで、  `idf.py build`  を実行して   hello_world   をビルドできます。

![ビルド結果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_espidf_buildresult.png)

次に、ターミナルを使用して CLion でプロジェクトの作業を続行できます。 これには、追加の CMake 構成は必要ありません。 または、コマンドラインなしでプロジェクトをロード、ビルド、実行できるように CMake を設定することもできます（以下を参照）。

## CLion で ESPCMake プロジェクトを構成する

Procedure: Hello-world プロジェクトを開く

1. メインメニューで、  `ファイル | オープン`  に移動し、  `esp/esp-idf/examples/get-started/hello_world`  フォルダーを選択します。

2. プロジェクトとして開く​   をクリックして、 [ソースを信頼します](project-security.html)。

この時点で、プロジェクトの読み込みが失敗する可能性があります。

> **Tip:**
> Windows で作業している場合は、  `設定 | ビルド、実行、デプロイ | ツールチェーン`  に移動して、プロジェクトのツールチェーンをセットアップします。 詳細については、 [チュートリアル: Windows で CLion を設定する](quick-tutorial-on-configuring-clion-on-windows.html) を参照してください。

### 環境を調達する

ツールチェーン設定を使用して、ESP-IDF 環境スクリプトを指定します。

ESP-IDF インストールには 1 つまたは 2 つの環境ファイルが必要です。 Python 仮想環境の場合は 2 つのファイルが必要です。

Procedure: 環境スクリプトをソースする (macOS の例)

1. `設定 | ビルド、実行、デプロイ | ツールチェーン`  に進みます。

2. 「   命名方法名   」フィールドの横にある「   環境を追加する   」をクリックし、「   次のファイルから   」をクリックします。

3. `esp/esp-idf`  に移動し、  `export.sh`  を選択します：

![ツールチェーン環境スクリプトの設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_espidf_toolchain_envscript.png)

4. ツールチェーン設定を保存します。

5. プロジェクトは自動的に再ロードされます。 エラーが発生した場合は、メインメニューから  `ツール | CMake | キャッシュをリセットしてプロジェクトを再ロードする`  を呼び出します。

Procedure: カスタムスクリプトを使用して環境を調達する (Windows の例)

Windows では、ESP-IDF 環境をセットアップするには 2 つのファイルが必要です。 これを自動化するには、両方をロードしてツールチェーン環境ファイルとして使用する簡単なスクリプトを作成できます。

1. プロジェクトフォルダーにスクリプトファイルを作成します。 例:  `espidf_source.bat`  。

2. 次の行をカスタマイズしてスクリプトに追加します。

```BASH
@call C:\Espressif\python_env\idf5.0_py3.8_env\Scripts\activate.bat
@call C:\Espressif\frameworks\esp-idf-v5.0-2\export.bat

```

3. `設定 | ビルド、実行、デプロイ | ツールチェーン`  に進みます。

4. 「   命名方法名   」フィールドの横にある「   環境を追加する   」をクリックし、「   次のファイルから   」をクリックします。

5. 新しく作成したファイルを選択します。

6. ツールチェーン設定を保存します。

7. プロジェクトは自動的に再ロードされます。 エラーが発生した場合は、メインメニューから  `ツール | CMake | キャッシュをリセットしてプロジェクトを再ロードする`  を呼び出します。

Procedure: プロジェクトのビルド

1. CLion は、検出されたすべての CMake ターゲットに対して [実行 / デバッグ構成](run-debug-configuration.html)を自動的に作成します。

プロジェクトをビルドするには、構成スイッチャーで   アプリ   を選択し、ハンマーアイコンをクリックするか、  `Ctrl + F9`  を押してこの構成の [ビルド](build-actions.html) を実行します。

2. この時点で、すべての CLion コードインサイト機能が ESP プロジェクトで利用可能です。 いくつかの例については、 [Windows 上の CLion を使用した ESP32 用の開発: コードインサイト(英語)](https://www.youtube.com/watch?v=M6fa7tzZdLw&t=399s)を参照してください。

Procedure: CLion の ESP-32 チップをフラッシュして監視する

> **Tip:**
> ビデオの説明については、 [Windows 上の CLion を使用した ESP32 用の開発: ESP-32 チップのフラッシュと監視(英語)](https://www.youtube.com/watch?v=M6fa7tzZdLw&t=482s)を参照してください

1. 構成スイッチャーで   構成スイッチャーでフラッシュ  を選択し、ハンマーアイコンをクリックするか、  `Ctrl + F9` を押してビルドします。

ビルド出力で、チップの点滅のパーセンテージインジケーターを確認できます。

2. モニター   構成を選択して構築します。 シリアルポートを開けないというエラーが表示された場合は、次の手順を実行します。

1.    デバイスマネージャー   を開き、ESP デバイスで使用されているポートを確認します。

2.  CMake 設定の   環境   変数にもう 1 つの変数  `ESPPORT`  を追加します。 値をポートに設定します（例:  `COM3`  ）。

3.  プロジェクトが再ロードされた後、   モニター   構成を再度ビルドします。 ESP-32 チップは期待どおりに報告する必要があります。

## トラブルシューティング (Windows)

Windows で  `Git executable not found`  エラーが発生する場合は、ESP-IDF の  `find_package(Git)`  コマンドで検出可能な場所に Git がインストールされていることを確認してください。

これを回避するには、  `git.exe`  バイナリへのフルパスを使用して  `GIT`  環境変数を追加します。  `esp/idf/tools/cmake/git_submodules.cmake`  を変更することでそれを行うことができます。 最初の行で、  `find_package(Git)`  を次のように変更します。

```CMAKE
if (DEFINED ENV{GIT})
    execute_process(COMMAND $ENV{GIT} --version
    OUTPUT_VARIABLE git_version
    ERROR_QUIET
    OUTPUT_STRIP_TRAILING_WHITESPACE)
    if (git_version MATCHES "^git version [0-9]")
        string(REPLACE "git version " "" GIT_VERSION_STRING "${git_version}")
        set(GIT_FOUND True)
        set(GIT_EXECUTABLE $ENV{GIT})
    endif()
    unset(git_version)
else()
    find_package(Git)
endif ()

```

## See also

### 外部リンク

[CLion blog: Developing for ESP32 With CLion on Windows](https://blog.jetbrains.com/clion/2021/09/developing-for-esp32-with-clion-on-windows/) [Video: Developing for ESP32 With CLion on Windows](https://www.youtube.com/watch?v=M6fa7tzZdLw)

