入门 Zed Industries 2026-09-14 17:42:19 · 0 阅读

第16章 Zed 中的 Dev Containers 使用指南

Dev Containers 通过在容器配置中定义项目的依赖项、工具及设置，提供一致且可复现的开发环境。

如果仓库中包含 .devcontainer/devcontainer.json 文件，Zed 即可在开发容器中打开该项目。

前提条件

系统需安装 Docker 或 Podman，并在 PATH 中可用。若使用 podman，需在 Zed 的 settings.json 中将 use_podman 设置为 true。
项目中必须包含 .devcontainer/devcontainer.json 目录或文件。

默认情况下，当 docker buildx 插件可用时，Zed 会使用 BuildKit 构建 Dev Container 镜像。若你的 Docker 兼容引擎不支持集成的 BuildKit（例如通过 Docker-API 桥接访问的 Apple Container），请在 settings.json 中设置 "dev_container_use_buildkit": false，以改用经典 Docker 构建器。

在 Zed 中使用 Dev Containers

自动提示

当打开包含 .devcontainer/devcontainer.json 目录或文件的项目时，Zed 会弹出提示，询问是否在 Dev Container 中打开该项目。选择“在容器中打开”将执行以下操作：

构建 Dev Container 镜像（如需要）。
启动容器。
重新打开项目并连接至容器环境。

手动打开

若忽略了提示，或希望稍后在容器中重新打开项目，可通过 Zed 的命令面板执行“Project: Open Remote”命令，选择“在 Dev Container 中打开”选项。此外，也可通过快捷键 {#kb projects::OpenRemote} 唤起远程项目弹窗，并选择“Connect Dev Container”选项。

编辑 Dev Container 配置

若修改了 .devcontainer/devcontainer.json，Zed 目前不会自动重建或重新加载容器。更改配置后，请手动停止或终止现有容器（例如通过 docker kill <container>），然后重新在容器中打开项目。

在 Dev Container 中工作

连接成功后，Zed 会在容器环境中运行任务、终端和语言服务器。根据 dev container 规范，工作区中的文件会被挂载到容器内。

扩展

你可以在 .devcontainer/devcontainer.json 的 "customizations" 字段中指定扩展，格式如下：

{
  ...
  "customizations": {
    "zed": {
      "extensions": ["vue", "ruby"],
    },
    "vscode": {
      ...
    },
    "codespaces": {
      ...
    },
  }
}

请注意，扩展是为 Zed 会话加载的，因此这些扩展也会存在于你本地的 Zed 实例中。