# Vcpkg の統合

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

プロジェクトの依存関係や外部ライブラリを管理しやすくするために、CLion は C/C++ のパッケージマネージャー [vcpkg](https://vcpkg.io/en/index.html) と連携しています。

> **Note:**
> 現在の制限：
>
>
>
> * vcpkg 機能の完全なセットは、 [CMake](quick-cmake-tutorial.html) プロジェクトで利用できます。 他の [プロジェクト形式](project-models.html)の場合は、パッケージの参照とインストールのみがサポートされます。
>
> * サポートされているツールチェーンは、 [Windows シグウィン](quick-tutorial-on-configuring-clion-on-windows.html#Cygwin)、 [WSL](how-to-use-wsl-development-environment-in-product.html)、 [Docker](clion-toolchains-in-docker.html)、 [リモート](remote-projects-support.html)を 除く すべてです。
>
>
>
> CLion トラッカーの対応するチケットについては、 [既知の問題](#known-issues)を参照してください。

Procedure: vcpkg をインストールする。

> **Tip:**
> Vcpkg がシステムにインストールされます。 vcpkg の複数のインスタンスをインストールし、それぞれに異なるパッケージセットを含めることができます。
>
>
>
> また、1 つの vcpkg リポジトリに複数のプロジェクトをリンクすることもできます。

1. メインメニューから  `表示 | ツールウィンドウ | Vcpkg`  を選択して、   Vcpkg   ツールウィンドウを開きます。

2. ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックします：

![vcpkg ツールウィンドウに vcpkg ボタンを追加する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_add_vcpkg_icon.png)

3. Vcpkg リポジトリを追加   ダイアログでインストール設定を指定します。

![vcpkg リポジトリの追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_add_vcpkg_dialog.png)

* vcpkg リポジトリの name と URL 。

* インストールディレクトリ (または既定値を使用)。 vcpkg がすでにインストールされている場合は、このフィールドにその場所へのパスを指定します。

* 既存の CMake プロファイルに vcpkg 統合を追加する > **Note:** > このオプションは CMake プロジェクトでのみ使用できます。 CLion は CMake ツールチェーンファイルを利用して vcpkg と統合します。 ツールチェーンファイルをリンクする [CMake プロファイル](cmake-profile.html)を選択する。 インストール後、 `CMAKE_TOOLCHAIN_FILE` 変数を介して、選択したプロファイルの CMake のオプション に追加されたツールチェーンファイルを見つけることができます。

4. OK   をクリックして、インストールが完了するまで待ちます。

パッケージのリストが中央のペインに表示されます。 右側のペインには、選択したパッケージの説明とアクションが表示されます。

![Vcpkg ツールウィンドウ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_toolwindow_installsuccess.png)

> **Tip:**
> vcpkg がどのプロファイルにもリンクされていない場合は、グレー表示されます。   vcpkg の編集   ダイアログ ( ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.edit_dark.svg)) を使用してプロファイルにリンクします。
>
>
>
> ![Vcpkg はどの Cmake プロファイルにもリンクされていません](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_noprofile.png)

Procedure: パッケージを参照してインストールする

> **Note:**
> 特定のバージョンを選択するオプションはまだ実装されていません ( [CPP-32366(英語)](https://youtrack.jetbrains.com/issue/CPP-32366/vckpg-Add-ability-to-select-version-of-package))。 最新のパッケージバージョンのみをインストールできます。

1. 特定のパッケージを見つけるには、検索フィールドにその名前を入力し始める：

![パッケージの検索](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_search.png)

2. パッケージを選択して `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押すか、右側のペインで   インストール   をクリックします。

3. クラシックモードでは、パッケージが正常にインストールされた場合、CLion が  `vcpkg.json`  に追加し、マニフェストモードへ切り替えるよう促します:

![インストールのお知らせ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_install_addtojson_notification.png)

4. インストールされたパッケージは   インストール済み | クラシックモード   または   追加済み | マニフェストモード   にあります。

> **Note:**
> クラシックモードではリポジトリ内のすべてのパッケージが表示され、 [マニフェストモード](#switch-manifest)では  `vcpkg.json`  に追加されたパッケージが表示されます。

クラシックモード:

![インストール済みパッケージのサブツリー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_installed.png)

マニフェストモード:

![vcpk.json に追加されたパッケージ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_installed_manifestmode.png)

Procedure: マニフェストモードに切り替える。

> **Note:**
> プロジェクトのルートに  `vcpkg.json`  ファイルがある場合、CLion は自動的にマニフェストモードに切り替わります。
>
>
>
> クラシックモードとマニフェストモードは相互に排他的であることに注意してください。

1. マニフェストモードに切り替える   ボタンをクリックします:

![マニフェストモードに切り替える](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_switchtomanifest.png)

2. `vcpkg.json`  に追加するパッケージを選択します:

![vcpkg.json に追加するパッケージ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_switchtomanifest_dialog.png)

3. CLion は  `vcpkg.json`  ファイルを作成し、パッケージを追加してプロジェクトをマニフェストモードに切り替えます:

![マニフェストモードに切り替えました](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_manifest_switched.png)

Procedure: コンソール出力を調査する

コンソール: vcpkg   は、すべての vcpkg コマンドと完全な出力を表示する読み取り専用タブです。

![「Vcpkg コンソール」タブ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_consletab.png)

> **Tip:**
> 上矢印と下矢印を使用してコマンド間を移動します:
>
> ![「コンソール」タブでコマンド間を移動する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_console_jump.png)

* エラーが発生した場合、たとえばパッケージのインストール中など、CLion は通知メッセージを表示する。   出力を表示   をクリックしてコンソールタブを開き、問題を調査します。

![インストールエラーメッセージ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_errormessage.png)

* vcpkg 利用中はいつでも   コンソール   タブに切り替えられる。 タブは   コンソールを表示   ボタンからもアクセス可能です。

![「コンソールを表示」ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_showconsole.png)

Procedure: 複数のパッケージのインストール / 削除

1. ツリー内の複数のパッケージを選択します。

2. 次のショートカットを使用します。

* `vcpkg.json` をインストールまたは追加するには、 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押します。

* 削除するには、 `Alt+Delete` / `⌘⌫` を押します。

Procedure: パッケージの使用を開始する

パッケージは [CMakeLists.txt](cmakelists-txt-file.html) に追加する必要があります。 ほとんどのパッケージでは、vcpkg は CMake スクリプトに含めるコードを提供します。

1. vcpkg からのヒントがある場合、通知に   パッケージを CMakeLists.txt に追加   オプションが表示される：

![パッケージを CMakeLists.txt に追加する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_add_cmakelists.png)

2. 提案されたコードを  `CMakeLists.txt`  ファイルにコピーしてください。 必要に応じて、ターゲットリンク名（デフォルトは  `main` ）をパッケージのリンク先として希望する名前に変更することができる。

![CMakeLists.txt に貼り付けるコード](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_add_cmakelists_code.png)

Procedure: vcpkg とパッケージを更新する

更新とアップグレードには、次のツールウィンドウアクションを使用します。

* すべて更新   は、vcpkg Git リポジトリを最新バージョンに更新し、利用可能なパッケージ更新をチェックします。

![すべてのアイコンを更新](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_updateall_icon.png)

* すべてアップグレード   は、vcpkg Git リポジトリを最新バージョンに更新してから、インストールされているすべてのパッケージを最新バージョンに更新します。

![すべてのアイコンをアップグレード](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_upgradeall_icon.png)

* アップデートの確認   ( ![三点アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox-ide-settings-icon.png) メニュー) は、vcpkg Git リポジトリの新しいバージョンがあるかどうかを確認します。

* リポジトリを更新   ( ![三点アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox-ide-settings-icon.png) メニュー) は、vcpkg Git リポジトリの現在のバージョンをチェックして、利用可能なパッケージの更新を確認します。

* リポジトリをアップグレード   ( ![三点アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox-ide-settings-icon.png) メニュー) は、vcpkg Git リポジトリの現在のバージョンで利用可能なパッケージの更新を確認し、インストールします。

* Vcpkg リポジトリを更新   ( ![三点アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox-ide-settings-icon.png) メニュー) は、vcpkg Git リポジトリを最新バージョンに更新します。

Procedure: パッケージを 1 つずつアップグレードする

アップグレードできるパッケージは、警告記号で示されます。

* パッケージを選択し、右側のペインで   パッケージをアップグレード   アイコンをクリックします:

![パッケージを 1 つずつアップグレードする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_updatepackages_onebyone.png)

Procedure: リポジトリの自動更新

* ツールバーの ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) をクリックし、   IDE 起動時にリポジトリを自動更新   を選択すると、CLion が IDE 起動ごとにリポジトリの更新を確認します。

![IDE の起動時にリポジトリを自動更新するオプション](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_autoudate_onrestart.png)

Procedure: クイックフィックスを使用して不足しているパッケージを追加する

* まだインストールされていないパッケージのヘッダーを含めると、  ファイルが見つからないという エラーでコンパイルが失敗します。 エラーメッセージの横にある   修正   をクリックします。

![ビルドエラーメッセージのクイックフィックスリンク](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_quickfix.png)

CLion は不足しているパッケージのインストールを提案する：

![不足しているパッケージをすばやく修正するための提案](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_quickfix_suggestion.png)

* インストールの候補が複数ある場合は、   修正   メニューからリストを開きます。

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

ダイアログでインストールするパッケージを選択します。

![パッケージ候補ダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_quickfix_candidates_dialog.png)

> **Tip:**
> 修正   、パッケージマネージャーにリンクされていないプロファイルに対しても機能します。

Procedure: システム CMake と Ninja の使用を強制する

[プロファイル](cmake-profile.html)環境から vcpkg に CMake と Ninja を [強制的](https://learn.microsoft.com/en-us/vcpkg/users/config-environment#vcpkg_force_system_binaries)に使用させることができます。

1. 左側のペインで   vcpkg の編集   ボタンをクリックします:

![「vcpkg の編集」アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_editicon.png)

2. 詳細設定   セクションを展開し、   システムバイナリを使用   チェックボックスを設定します:

![システムバイナリの使用を強制する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_usesysbins.png)

Procedure: トラブルシューティング: vcpkg は MinGW トリプレットの代わりに x64-windows トリプレットをインストールする

MinGW にパッケージを追加すると、標準の vcpkg は [MinGW トリプレット](https://learn.microsoft.com/en-us/vcpkg/users/platforms/mingw#mingw-native)ではなく x64-windows トリプレットをインストールします。 CLion はこれを自動的に修正できます。

1. エラーメッセージ内の   修正   をクリックします。

![MinGW トリプレットの修正](https://resources.jetbrains.com/help/img/idea/2026.3/cl_vcpkg_mingw_fix.png)

2. クラシックモードでは、CLion は現在のプロファイルの   CMake のオプション   に  `VCPKG_TARGET_TRIPLET`  を追加します。

マニフェストモードでは、CLion は  `VCPKG_TARGET_TRIPLET`  を   CMake のオプション   に追加し、さらに 2 つの環境変数  `VCPKG_DEFAULT_TRIPLET`  と  `VCPKG_DEFAULT_HOST_TRIPLET`  を追加します。

## 既知の問題と制限

* 現在、vcpkg のサポートは、Cygwin ( [CPP-31665(英語)](https://youtrack.jetbrains.com/issue/CPP-31665))、リモート ( [CPP-30683(英語)](https://youtrack.jetbrains.com/issue/CPP-30683))、Docker ( [CPP-30684(英語)](https://youtrack.jetbrains.com/issue/CPP-30684))、および WSL ( [CPP-30685(英語)](https://youtrack.jetbrains.com/issue/CPP-30685)) のツールチェーンでは機能していません。

* エディターで欠落しているパッケージのクイックフィックスは開発中です ( [CPP-31662(英語)](https://youtrack.jetbrains.com/issue/CPP-31662))。

## See also

### 外部リンク

[vcpkg's GitHub page](https://github.com/microsoft/vcpkg)

### ハウツー

[クイック CMake チュートリアル](quick-cmake-tutorial.html) [CMake profiles](cmake-profile.html) [CLion toolchains](how-to-create-toolchain-in-clion.html)

### プロシージャ

[Conan プラグイン](conan-plugin.html)

