限制

在使用 Dev Containers 时，您需要注意一些限制。

Windows 上的 Dev Containers

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

从 VCS 项目创建 Dev Containers

当您启动一个从 VCS 项目创建的开发容器时，后台会执行以下步骤：

构建 Dev Container

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

为避免在 devcontainer.json 属性、 Dockerfile 以及与挂载过程和相对路径相关的 Docker Compose 中出现错误，我们会列出所有构建步骤，并附带一条警告，建议检查您的开发容器配置。

请检查以下警告示例：

                    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 中运行容器

不支持从运行的 backend-client 连接创建 Dev Container 的场景。

例如，您通过 SSH 连接到远程项目，并添加了一个 devcontainer.json。无法从创建的 devcontainer.json 文件启动 Dev 容器。

但是，您可以使用以下步骤作为变通方法：

在远程机器上创建 Dev Container

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

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

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

            XDG_CACHE_HOME
            XDG_CONFIG_HOME
            XDG_DATA_HOME
        
  

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