限制

使用 Dev Container 时，您需要注意以下若干限制。

Windows 上的 Dev Container

不支持基于 Windows 操作系统的 Dev Container 镜像。

从 VCS 项目创建 Dev Container

当您启动一个从 VCS 项目创建的 Dev Container 时，后台将执行以下步骤：

构建 Dev Container

会为 git clone 准备辅助容器。
将存储库克隆到 Docker 卷中。
在远程服务器上创建 tmp 工作目录。
从该卷中将构建上下文提取到 tmp 目录。
Docker 获取构建 Dev Container 所需的上下文。
随后会清理临时工作目录。

为避免与挂载过程和相对路径相关的 devcontainer.json 属性、 Dockerfile 和 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

创建一个通过 SSH 的 Docker 连接。
在本地安装 Docker CLI。
在 Windows 上，您可以在不安装 Docker Desktop 的情况下安装它；我们不需要 Docker 守护进程，只需要 Docker CLI。
将 SSH 主机上的所有更改提交到 Git。
使用远程服务器和 git clone 命令创建 Dev Container。

远程后端上的 XDG_* 环境变量

以下环境变量由远程后端 IDE 使用，且无法在 devcontainer.json 配置文件中重新设置：

            XDG_CACHE_HOME
            XDG_CONFIG_HOME
            XDG_DATA_HOME
        
  

最后修改日期： 2025年 12月 2日