限制

使用 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

创建 Docker 到 SSH 的连接。
在本地安装 Docker CLI。
在 Windows 上，您可在不安装 Docker 桌面版的情况下进行安装；我们不需要 Docker 守护程序，仅需要 Docker CLI。
将 SSH 机器上的所有更改提交至 Git。
使用 remote server 和 git clone 命令创建 Dev Container。

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

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

            XDG_CACHE_HOME
            XDG_CONFIG_HOME
            XDG_DATA_HOME
        
  

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