限制

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

Windows 上的 Dev Containers

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

从 VCS 项目创建 Dev Containers

当您从 VCS 项目启动 Dev Container 时，会在后台执行以下步骤：

构建 Dev Container

git clone 的辅助容器已准备就绪。
代码仓库已克隆到 Docker 卷中。
远程服务器上已创建 tmp 工作目录。
已将构建上下文从卷中提取到 tmp 目录。
Docker 获取 Dev Container 构建的上下文。
随后会清理临时工作目录。

为了避免与挂载过程和相对路径相关的 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 中运行容器

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

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

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

在远程机器上创建 Dev Container

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

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

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

            XDG_CACHE_HOME
            XDG_CONFIG_HOME
            XDG_DATA_HOME
        
  

最后修改日期： 2025年 9月 26日