限制
使用 Dev Container 时，您需要注意一些限制。
Windows 上的 Dev Container
不支持基于 Windows 操作系统的 Dev Container 镜像。
从 VCS 项目创建 Dev Container
当您启动一个 从 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 中运行容器
不支持从正在运行的后端-客户端连接创建 Dev Container 的场景。
例如，您使用 SSH 连接到远程项目，并添加了一个 devcontainer.json。 无法从创建的 devcontainer.json 文件启动开发容器。
不过，您可以使用以下步骤作为替代方案：
在远程主机上创建 Dev Container
创建一个 通过 SSH 的 Docker 连接。
在本地安装 Docker CLI。
在 Windows 上，您可以在不安装 Docker Desktop 的情况下进行安装；我们不需要 Docker 守护进程，只需 Docker CLI 即可。
将 SSH 主机上的所有更改提交到 Git。
使用 远程服务器 和
git clone命令创建开发容器。
远程后端上的 XDG_* 环境变量
以下环境变量由远程后端 IDE 使用，且不能在 devcontainer.json 配置文件中重新设置：
XDG_CACHE_HOME
XDG_CONFIG_HOME
XDG_DATA_HOME
最后修改日期： 2025年 9月 26日