IntelliJ IDEA 2026.1 Help

制限

Dev Container を使用する際には、留意すべき制限事項がいくつかあります。

Windows 上の Dev Container

Windows OS ベースの Dev Container イメージはサポートされていません。

VCS プロジェクトから Dev Container を作成する

VCS プロジェクトからの Dev Container を起動すると、内部で次の手順が実行されます。

Dev Container を構築する

  1. git clone 用のヘルパーコンテナーが準備されています。

  2. リポジトリは Docker ボリュームにクローンされます。

  3. tmp 作業ディレクトリがリモートサーバー上に作成されます。

  4. ビルドコンテキストはボリュームから tmp ディレクトリに抽出されます。

  5. Docker は Dev Container ビルのコンテキストを取得します。

  6. その後、一時作業ディレクトリがクリーンアップされます。

マウントプロセスと相対パスに関連する devcontainer.json プロパティ、Docker ファイル、および Docker-compose のエラーを回避するために、すべてのビルド手順をリストし、Dev Container 構成を確認することを提案する警告を含めます。

次の警告例を確認してください。

WARNING: Mount from /var/folders/0h/f3gs9sz96xdbqnp63t7bs4b80000gn/T/jb_devcontainer_sources_12dc6d53a2ae8fac66e0a54e76f501464151078046496127718/DevCont_templates/.devcontainer to /workspaces is referenced to temporary folder used for build. This may lead to unexpected behaviour or not working devcontainer. Please check that your devcontainer configuration is expected for build from git repository.

リモート IDE 内でコンテナーを実行する

実行中のバックエンドクライアント接続から Dev Container を作成するシナリオはサポートされていません。

例: SSH 接続を使用してリモートプロジェクトに接続し、 devcontainer.json を追加しました。 作成された devcontainer.json ファイルから Dev Container を起動するオプションはありません。

ただし、回避策として次の手順を使用できます。

リモートマシンで Dev Container を作成する

  1. Docker の SSH への接続を作成します。

  2. Docker CLI をローカルにインストールします。

    Windows では、Docker デスクトップなしでインストールできます。Docker デーモンは必要なく、Docker CLI のみが必要です。

  3. SSH マシンからのすべての変更を Git にコミットします。

  4. リモートサーバーgit clone コマンドを使用して Dev Container を作成します。

リモートバックエンドの XDG_* 環境変数

次の環境変数はリモートバックエンド IDE によって使用され、 devcontainer.json 構成ファイルで再割り当てすることはできません。

XDG_CACHE_HOME XDG_CONFIG_HOME XDG_DATA_HOME
2026 年 3 月 30 日