现已推出!阅读 10 月份的新功能和修复。

提高磁盘性能

默认情况下,Dev Containers 扩展使用“绑定挂载”来访问您本地文件系统中的源代码。虽然这是最简单的选项,但在 macOS 和 Windows 上,您可能会遇到运行 yarn install 等命令时的磁盘性能较慢的问题。您可以采取一些措施来解决这些问题。

将您的源代码存储在 Windows 上的 WSL 2 文件系统中

Windows 10 2004 及更高版本包含 Windows 子系统 for Linux (WSL 2) 的改进版本,该版本提供完整的 Linux 内核,并且比 WSL 1 的性能显著提高。Docker Desktop 2.3+ 包含一个新的 WSL 2 引擎,它在 WSL 中而不是在 VM 中运行 Docker。因此,如果您将源代码存储在 WSL 2 文件系统中,您将看到性能提升,以及对设置权限等事项的更好兼容性。

请参阅 在 Windows 上在容器中打开 WSL 2 文件夹,了解有关从 VS Code 使用此新引擎的详细信息。

视频:加速 Windows 上的 Dev Containers

使用容器卷中的克隆存储库

Dev Containers: Clone Repository in Container Volume... 命令使用一个隔离的本地 Docker 命名卷,而不是绑定到本地文件系统。除了不会污染您的文件树之外,本地卷还具有在 Windows 和 macOS 上提高性能的额外优势。

请参阅 在隔离的容器卷中打开 Git 存储库或 GitHub PR,了解有关使用此方法的详细信息。

接下来的两节将概述如何在其他情况下使用命名卷。

使用目标命名卷

由于 macOS 和 Windows 在 VM 中运行容器,“绑定”挂载不像直接使用容器的文件系统那样快。幸运的是,Docker 有本地“命名卷”的概念,它可以像容器的文件系统一样工作,但在容器重建后仍然存在。这使得它非常适合存储像 node_modules、数据文件夹或 build 等输出文件夹这样的包文件夹,在这些文件夹中写性能至关重要。请根据您在 devcontainer.json 中引用的内容,按照以下步骤操作。

Dockerfile 或镜像:

让我们使用 vscode-remote-try-node 存储库来演示如何加速 yarn install

请按照以下步骤操作

  1. devcontainer.json 中使用 workspaceMount 属性告诉 VS Code 在哪里绑定您的源代码。然后使用 mounts 属性(VS Code 1.41+)将 node_modules 子文件夹挂载到命名本地卷中。

    "mounts": [
        "source=${localWorkspaceFolderBasename}-node_modules,target=${containerWorkspaceFolder}/node_modules,type=volume"
    ]
    

    注意:您可以在 source 中使用 ${localWorkspaceFolderBasename}${devcontainerId} 或硬编码名称。

  2. 由于此存储库 以非 root “node” 用户身份运行 VS Code,因此我们需要添加一个 postCreateCommand 来确保用户可以访问该文件夹。

    "remoteUser": "node",
    "mounts": [
        "source=${localWorkspaceFolderBasename}-node_modules,target=${containerWorkspaceFolder}/node_modules,type=volume"
    ],
    "postCreateCommand": "sudo chown node node_modules"
    

    如果您将在容器中以 root 身份运行,则此第二步不是必需的。

如果您已经构建了容器并连接到它,请从命令面板(F1)运行 Dev Containers: Rebuild Container 来获取更改。否则,运行 Dev Containers: Open Folder in Container... 来连接到容器。

关于此方法的两个注意事项

  1. 如果您删除了容器中的 node_modules 文件夹,它可能会丢失与卷的连接。当需要时,请改为删除 node_modules 文件夹的内容(rm -rf node_modules/* node_modules/.*)。

  2. 您会发现,使用此方法会在本地创建一个空的 node_modules 文件夹。这是因为容器中的卷挂载点位于本地文件系统绑定挂载点内。这是预期且无害的。

Docker Compose:

虽然 vscode-remote-try-node 不使用 Docker Compose,但步骤类似,只是卷挂载配置放置在不同的文件中。

  1. 在您的 Docker Compose 文件(或 扩展的 Docker Compose 文件)中,为适当的服务添加一个命名本地卷挂载到 node_modules 子文件夹。例如

    version: '3'
    services:
      your-service-name-here:
        volumes:
          # Or wherever you've mounted your source code
          - .:/workspace:cached
          - try-node-node_modules:/workspace/node_modules
        # ...
    
    volumes:
      try-node-node_modules:
    
  2. 接下来,请确保 devcontainer.json 中的 workspaceFolder 属性与您的实际源代码挂载的位置匹配

    "workspaceFolder": "/workspace"
    
  3. 如果您在容器中以 除 root 用户以外的用户身份运行,请添加一个 postCreateCommand 来更新您挂载的文件夹的所有者,因为该文件夹可能是以 root 身份挂载的。将 user-name-goes-here 替换为适当的用户。

    "remoteUser": "node",
    "workspaceFolder": "/workspace",
    "postCreateCommand": "sudo chown user-name-goes-here node_modules"
    

如果您已经构建了容器并连接到它,请从命令面板(F1)运行 Dev Containers: Rebuild Container 来获取更改。否则,运行 Dev Containers: Open Folder in Container... 来连接到容器。

视频:加速 dev 容器中的 npm install

为您的整个源代码树使用命名卷

最后,如果以上选项都不符合您的需求,您可以更进一步,将整个源代码树克隆到命名卷中,而不是克隆到本地。您可以通过获取现有的 devcontainer.json 配置并将其修改如下来设置命名卷(将 your-volume-name-here 更新为您要为卷命名的任何名称)。

根据您在 devcontainer.json 中引用的内容

  • Dockerfile 或镜像:在 devcontainer.json 中使用以下属性将本地命名卷挂载到容器中

    "workspaceMount": "source=your-volume-name-here,target=/workspace,type=volume"
    "workspaceFolder": "/workspace",
    
  • Docker Compose:更新(或 扩展)您的 docker-compose.yml,为适当的服务添加以下内容

    version: '3'
    services:
      your-service-name-here:
        volumes:
            - your-volume-name-here:/workspace
        # ...
    
    volumes:
      your-volume-name-here:
    

    您还需要确保 devcontainer.json 中的 workspaceFolder 属性与卷挂载的位置(或卷内的子文件夹)匹配

    "workspaceFolder": "/workspace"
    

如果您已经构建了容器并连接到它,请从命令面板(F1)运行 Dev Containers: Rebuild Container 来获取更改。否则,运行 Dev Containers: Open Folder in Container... 来连接到容器。

接下来,要么使用命令面板中的 Git: Clone 命令,要么启动集成终端⌃⇧` (Windows, Linux Ctrl+Shift+`)),然后使用 git clone 命令将您的源代码克隆到 /workspace 文件夹中。

最后,使用 文件 > 打开... / 打开文件夹... 命令在容器中打开克隆的存储库。