# ROS2 セットアップチュートリアル

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

[ROS2(英語)](https://docs.ros.org/en/lyrical/index.html) は、ROS の最新バージョンである Robot Operating System であり、ロボットアプリケーション用に設計されたライブラリとツールのセットです。

[このチュートリアルでは、colcon(英語)](https://colcon.readthedocs.io/en/released/) で構築された ROS2 アプリケーションを開発するための IDE として CLion を使用する方法について説明します。  catkin  ビルドツールを使用する古い ROS ディストリビューションを使用している場合は、 [前のチュートリアル](ros-setup-tutorial.html)を参照してください。

以下の手順は Windows で次のプロシージャを示しています：ROS2 ワークスペースの作成、CLion でコンパイルデータベースプロジェクトとして開く、ビルド、パッケージの実行・デバッグ、別のパッケージの追加、およびワークスペースの再ビルド。

Procedure: ROS2 環境を準備する

1. システムに ROS2 を [インストール(英語)](https://docs.ros.org/en/foxy/Installation.html)します。

2. ROS2 インストールの [ソーシング(英語)](https://docs.ros.org/en/foxy/Tutorials/Configuring-ROS2-Environment.html#source-the-setup-files)が成功することを確認してください。 問題が発生した場合は、同じガイドのヒントに従ってください。

Procedure: ワークスペースを作成する

> **Note:**
> すでにワークスペースがある場合は、 [ワークスペースを構築し、compilation database を生成する](#build-ws)に移動します。

例として、公式の [シンプルなパブリッシャーとサブスクライバー (C++)(英語)](https://docs.ros.org/en/foxy/Tutorials/Writing-A-Simple-Cpp-Publisher-And-Subscriber.html) ガイドを取り上げます。

1. 管理者モードでターミナルを開きます。

2. [ソース (英語)](https://docs.ros.org/en/foxy/Tutorials/Configuring-ROS2-Environment.html#source-the-setup-files)ROS2 インストール。 私たちの場合、コマンド

```CONSOLE
call C:\dev\ros2\ros2-windows\local_setup.bat
```

> **Tip:**
> RTI ConnextDDS 環境スクリプトが見つかりません 警告が表示された場合は、このチュートリアルの範囲内で無視しても問題ありません。

3. 新しいワークスペース用のディレクトリを作成し、そこに移動します

```CONSOLE
md \dev_ws\src
cd \dev_ws\src

```

4. publisher-subscriber  パッケージを作成する

```CONSOLE
ros2 pkg create --build-type ament_cmake cpp_pubsub
```

次の [手順(英語)](https://docs.ros.org/en/foxy/Tutorials/Writing-A-Simple-Cpp-Publisher-And-Subscriber.html#tasks)に従って、ビルドするまで、ソースファイル  `CMakeLists.txt`  および  `package.xml`  を取得します。

この時点で、次のフォルダー構造になっています。

```CONSOLE
|_dev_ws
   |_src
      |_cpp_pubsub
         |_include
         |_src
               subscriber_member_function.cpp
               publisher_member_function.cpp
           CMakeLists.txt
           package.xml

```

Procedure: ターミナルでワークスペースを構築し、compilation database を生成する

CLion で ROS2 ワークスペースを開くことができるようにするために、 [CMAKE_EXPORT_COMPILE_COMMANDS(英語)](https://cmake.org/cmake/help/latest/variable/CMAKE_EXPORT_COMPILE_COMMANDS.html) CMake フラグを使用して [JSON コンパイルデータベース](https://www.jetbrains.com/ja-jp/help/clion/compilation-database.html)を生成します。

このオプションは、Makefile および Ninja ジェネレーターの CMake でのみサポートされているため、  `-G`  を使用してジェネレーターを切り替える必要もあります。

1. 最初に ROS2 インストールを入手したのと同じターミナルで、ワークスペースレベルのフォルダー（この場合は  `dev_ws`  ）に移動し、実行します。

```CONSOLE
colcon build --cmake-args -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -G Ninja
```

> **Tip:**
> 生成プログラム: make の実行に失敗しました エラーが発生した場合は、ビルドする前に Visual C++ 環境を初期化してみてください。 必要に応じて、次のコマンドでパスをカスタマイズします。
>
> `call "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" x86_amd64`
>
> 次に、ビルドコマンドを再度実行します。

2. ビルドが終了したら、  `dev_ws\build`  に  `compile_commands.json`  ファイルが含まれていることを確認してください。  存在しない場合は、colcon  バージョンがワークスペースレベルのコンパイルデータベースの生成をサポートしていることを確認してください [（この問題(英語)](https://github.com/colcon/colcon-cmake/issues/61)を参照）。

Procedure: ソース環境で CLion を起動

1. 同じターミナルで、ワークスペースセットアップファイルを入手します。

```CONSOLE
call install/setup.bat
```

2. 次に、同じシェルから CLion を起動します。 詳細については、 [コマンドラインインターフェース](working-with-the-ide-features-from-command-line.html)を参照してください。

例: Toolbox を使用する場合、 [IDE を起動](https://www.jetbrains.com/ja-jp/help/clion/working-with-the-ide-features-from-command-line.html#generate-shell-scripts)するためのスクリプトを作成できます。 私たちの場合、  `C:\IDE_shell_scripts`  にあります。

```CONSOLE
cd C:\IDE_shell_scripts\
clion

```

3. その結果、CLion は ROS2 環境がすでに準備された状態で起動されます。

Procedure: CLion でワークスペースを開く

1. CLion で、メインメニューから  `ファイル | オープン`  を呼び出し、最上位の  `build`  ディレクトリにある  `compile_commands.json`  ファイルを選択します：

![ROS2 ワークスペースを compilation database プロジェクトとして開く](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_compdb_open.png)

2. プロジェクトとして開く   をクリックします：

![compDB をプロジェクトとして開く](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_compdb_open_as_prj.png)

3. プロジェクトが正常にロードされたことを確認してください：

![ROS2 ワークスペースの初期ロード](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_load_initial.png)

Procedure: プロジェクトルートを変更する

デフォルトでは、CLions は  `compile_commands.json`  ファイルを含むディレクトリをプロジェクトルートと見なします。 私たちの場合、  `build`  ディレクトリです。 プロジェクトツリーでは、実際のソースファイルは外部としてマークされています。

![外部とマークされたソースファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_external_sources.png)

正しいプロジェクト構造を取得するには、プロジェクトルートを実際のワークスペースディレクトリに設定する必要があります。

1. メインメニューから  `ツール | Compilation Database | プロジェクトルートを変更する`  を呼び出し、ワークスペースディレクトリ（この場合は  `dev_ws`  ）を選択します。

2. プロジェクトビューで変更を確認してください：

![ワークスペースプロジェクトルート](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_change_prj_dir.png)

この時点で、すべての CLion [編集機能](working-with-source-code.html)がワークスペースソースで完全に利用可能になります。

> **Tip:**
> デフォルトでは、VCS 更新などの外部イベントの場合を除いて、CLion は  `compile_command.json`  の変更時にプロジェクトを自動的に再読み込みしません。 この動作は  `設定 | ビルド、実行、デプロイ | ビルドツール`  で変更できます。
>
>
>
> [Compilation database: 自動再ロードを構成する](compilation-database.html#compdb_reload)を参照してください。

## パッケージの作成方法

CLion 内でパッケージをビルドして起動するために、  `colcon build`  中に実際に実行される CMake コマンドの [カスタムビルドターゲット](custom-build-targets.html#customtarget-compdb)を作成し、そのターゲットの [カスタムアプリケーション構成を作成](custom-build-targets.html#custom-rundebug)します。

Procedure: 1。 'colconbuild' コマンドのスクリプトを作成する

1. ビルドログディレクトリに移動します。 私たちの場合、  `C:\dev_ws\log\latest_build\cpp_pubsub`  です。 最新のビルドから  `command.txt`  ファイルを開きます。

2. コマンドを別のファイルにコピーして、次のように変更します。

```BASH
"C:\Program Files\CMake\bin\cmake.EXE" C:\dev_ws\src\cpp_pubsub -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -G Ninja -DCMAKE_INSTALL_PREFIX=C:\dev_ws\install\cpp_pubsub
"C:\Program Files\CMake\bin\cmake.EXE" --build C:\dev_ws\build\cpp_pubsub -- -j8 -l8
"C:\Program Files\CMake\bin\cmake.EXE" --install C:\dev_ws\build\cpp_pubsub

```

> **Tip:**
> このスクリプトは、パッケージビルドディレクトリ  `build/cpp_pubsub`  から呼び出され、compilation database ファイルがそこで生成されます。 一貫性を保つために、最後に次のコマンドを追加することで、そのファイルをワークスペース  `build`  レベルまでコピーできます。
>
>
>
>
> ```BASH
> copy  C:\dev_ws\build\cpp_pubsub\compile_commands.json  C:\dev_ws\build
> ```

3. ファイルを  `.bat`  スクリプトとして保存します。 この例では、  `cmake_commands.bat`  と呼ばれ、  `c:\dev_ws\src\cpp_pubsub\`  に配置されます。

Procedure: 2。 カスタムビルドターゲットを作成する

1. CLion で、  `設定 | ビルド、実行、デプロイ | カスタムビルドターゲット`  に移動し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして新しいターゲットを追加します。

2. * ツールチェーン ～ Visual Studio を設定してください。 CLion での Visual Studio ツールチェーンの構成方法の詳細については、 [Windows チュートリアル](https://www.jetbrains.com/ja-jp/help/clion/quick-tutorial-on-configuring-clion-on-windows.html#MSVC)を参照してください。

* ビルド フィールドの横にある 3 つのドットアイコンをクリックします。 次に、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして外部を追加します。 プログラム フィールドで、新しく作成したスクリプトを選択します。 作業ディレクトリ をパッケージビルドディレクトリに設定します。

![CMake コマンドのカスタムビルドターゲットの作成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_customtool.png)

3. カスタムターゲットを保存します。

Procedure: 3。 カスタムビルドターゲットの実行 / デバッグ構成を作成する

パッケージ用のターゲットをビルドして起動できるようにするには、対応する [構成](run-debug-configuration.html)を作成する必要があります。

1. メインメニューで  `実行 | 実行構成の編集​`  に移動し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして   カスタムビルドアプリケーション   を選択します。

2. 構成設定で、   ターゲット​   を選択し、   起動前   領域から   ビルド   を必ず削除してください。

![カスタム構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_custom_config.png)

Procedure: 4。 パッケージを作成する

1. ツールバースイッチャーで構成を選択します：

![ビルドの構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_config_switcher.png)

2. ハンマーアイコンをクリックするか、  `Ctrl + F9`  を押します。 または、メインメニューから   ビルド | ビルド ' ビルド cpp_pubsub'   を呼び出します。

3. 実行ツールウィンドウで結果を確認します。

> **Tip:**
> パッケージ内のファイルを追加または削除した場合は、それに応じて compilation database が再生成されます。 必ずそれまたは [自動再ロードを構成する](compilation-database.html#compdb_reload)を再ロードしてください。

Procedure: パッケージを実行 / デバッグする

1. 実行構成の編集   ダイアログを再度開きます。

2. [ビルドの構成](#custom-apps)を次のように変更します。

* 実行可能ファイル を実際のパッケージバイナリに設定します。

* 管理者権限で実行する チェックボックスを選択します。 詳細については、 [root としてデバッグ](debug-as-root.html)を参照してください。

![パッケージの実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_run_talker_config.png)

3. 構成を保存すると、   実行   ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) または   デバッグ済み   ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) する準備が整います。 すべての CLion [デバッグ](debugging-code.html)および [動的解析](profiling-tools.html)機能がワークスペースコードで利用できます。

CLion は、ターゲットのツールチェーンからデバッガーを取得します。 私たちの場合、 [MSVC LLDB](quick-tutorial-on-configuring-clion-on-windows.html#msvc-debugger) です。

> **Tip:**
> デバッグのもう 1 つの方法は、CLion の外部でパッケージを起動してから、実行中のプロセスに [デバッガーを接続](attach-to-process.html)することです。

## ワークスペースを構築する方法

次に、CLion で新しいパッケージを追加し、ワークスペース全体を再構築する方法を見てみましょう。 これを説明するために、 [シンプルなサービスとクライアント(英語)](https://docs.ros.org/en/foxy/Tutorials/Writing-A-Simple-Cpp-Service-And-Client.html)パッケージを  `dev_ws`  ワークスペースに追加する例を取り上げます。

Procedure: 新しいパッケージファイルを準備する

1. ターミナルにおける [ソース (英語)](https://docs.ros.org/en/foxy/Tutorials/Configuring-ROS2-Environment.html#source-the-setup-files)  `dev_ws\src`  に ROS2 インストールと移動

2. 新規パッケージの作成

```CONSOLE
ros2 pkg create --build-type ament_cmake cpp_srvcli --dependencies rclcpp example_interfaces

```

3. [手順(英語)](https://docs.ros.org/en/foxy/Tutorials/Writing-A-Simple-Cpp-Service-And-Client.html#tasks)に従って、ビルドするまで、ソースファイル  `CMakeLists.txt`  および  `package.xml`  を取得します。

Procedure: ワークスペース全体を構築する

ワークスペース全体を（再）構築するために、 [colcon build

の外部ツール](configuring-third-party-tools.html)を構成し、CLion を移動せずにそれを呼び出します。

1. `設定 | ツール | 外部ツール`  に移動し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして新しいツールを追加します。

2. コマンドラインからビルドするときに使用したのと同じ  `colcon build`  コマンドを実行するようにツールを構成します。

![colcon ビルド用の外部ツール](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_colcon_build_external_tool.png)

> **Note:**
> 必ず   作業ディレクトリ   を設定してください。

3. ツールを保存した後、メインメニューの  `ツール | 外部ツール`  経由でツールを呼び出します。

4. 実行ツールウィンドウで結果を確認します：

![外部ツールを使用した colcon ビルドの結果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_colcon_build_results.png)

> **Tip:**
> 次回は、実行ツールウィンドウの ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) ボタンを使用して、ワークスペースを再構築します。

5. `compile_commands.json`  が再生成され、両方のパッケージのエンティティが含まれていることを確認します：

![ワークスペースの再構築後に Compilation database が再生成されました](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros2_compdb_regenerated.png)

6. 必ず compilation database を再ロードしてください（ `Ctrl+Shift+O` (Windows), `⌘ ⇧ I` (macOS), `⌘ ⇧ O` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ I` (macOS System Shortcuts), `Ctrl+Shift+O` (XWin), `Ctrl+Shift+O` (GNOME), `Ctrl+Shift+O` (KDE), `Ctrl+Shift+O` (Emacs), `Ctrl+Shift+O` (Sublime Text), `⌘ ⇧ I` (Sublime Text (macOS)), `⌘ ⇧ I` (Xcode), `Ctrl+Shift+O` (Visual Studio), `⌘ ⇧ I` (Visual Studio (macOS)), `Ctrl+Shift+O` (ReSharper), `⌘ ⇧ I` (ReSharper (macOS)), `Ctrl+Shift+O` (QtCreator), `Ctrl+Shift+O` (QtCreator (macOS)), `Ctrl+Shift+O` (NetBeans), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS)) を押すか、メインメニューから  `ツール | Compilation Database | Compilation Database プロジェクトを再ロード`  を呼び出します）。 プロジェクトを手動で再ロードしないようにするには、 [自動再ロードを構成する](compilation-database.html#compdb_reload)を使用します。

この時点で、両方のパッケージが CLion プロジェクトモデルに含まれており、通常どおりに操作できます。 2 番目のパッケージをビルドして実行するには、 [上記](#build-pkg)の手順に従います。

## See also

### オンラインドキュメント

[チュートリアル: Windows で CLion を設定する](quick-tutorial-on-configuring-clion-on-windows.html) [カスタムビルドのターゲットとアプリケーション](custom-build-targets.html) [Compilation database](compilation-database.html)

### 外部リンク

[ROS wiki](https://wiki.ros.org/)

