在VS Code DevContainers中指定Docker镜像为linux/amd64的方法

我使用搭载M2处理器（arm64架构）的MacBook Pro，需要启动一个基于amd64架构的Python 3.11-buster版本DevContainer，对应的Docker镜像为mcr.microsoft.com/devcontainers/python:0-3.11-buster。

已尝试的三种方法 #

• 在Dockerfile中添加platform参数：

FROM --platform=linux/amd64 mcr.microsoft.com/vscode/devcontainers/python:${VARIANT}

• 在.zshrc中设置环境变量：

DOCKER_DEFAULT_PLATFORM=linux/amd64

• 在devcontainer.json中配置runArgs：

"runArgs": [
    "--platform=linux/amd64"
  ],

构建时出现的错误 #

执行构建后弹出如下错误：

[183642 ms] Start: Run: docker inspect --type image mcr.microsoft.com/vscode/devcontainers/python:3.11-buster
[185190 ms] Error fetching image details: No manifest found for mcr.microsoft.com/vscode/devcontainers/python:3.11-buster.
[185190 ms] Start: Run: docker pull mcr.microsoft.com/vscode/devcontainers/python:3.11-buster
3.11-buster: Pulling from vscode/devcontainers/python
no matching manifest for linux/arm64/v8 in the manifest list entries
[186436 ms] []
[186436 ms] Error response from daemon: No such image: mcr.microsoft.com/vscode/devcontainers/python:3.11-buster

解决方法 #

1. 修正镜像标签匹配问题 #

错误日志显示Docker尝试拉取的是3.11-buster，但你实际需要的是0-3.11-buster，这说明${VARIANT}变量未正确设置。请在devcontainer.json中明确指定：

"build": {
  "dockerfile": "Dockerfile",
  "args": {
    "VARIANT": "0-3.11-buster"
  }
}

2. 多位置协同指定平台 #

单一位置指定平台可能被DevContainer的构建流程忽略，需同时配置：

• Dockerfile：直接写入完整镜像地址和平台参数

FROM --platform=linux/amd64 mcr.microsoft.com/devcontainers/python:0-3.11-buster

• devcontainer.json：同时在构建和运行阶段指定平台

"runArgs": ["--platform=linux/amd64"],
"build": {
  "dockerfile": "Dockerfile",
  "platform": "linux/amd64"
}

3. 手动拉取amd64镜像 #

先手动拉取指定平台的镜像，再启动DevContainer，避免自动拉取时的平台匹配错误：

docker pull --platform=linux/amd64 mcr.microsoft.com/devcontainers/python:0-3.11-buster

4. 启用Docker的Rosetta模拟 #

打开Docker Desktop设置，在「Features in Development」中开启「Use Rosetta for x86/amd64 emulation」，提升arm64机器运行amd64容器的兼容性和性能。

内容的提问来源于stack exchange，提问作者Joaquín L. Robles