VSCode Remote-Containers 项目中的容器构建缓存问题解析

问题背景

在VSCode Remote-Containers扩展（版本1.88.1）中，当使用devcontainer.json直接指定基础镜像而非通过Dockerfile构建时，发现"Rebuild Container Without Cache"功能存在一个关键缺陷。该功能本应完全禁用构建缓存，确保所有层都重新构建，但实际上并未添加--no-cache参数到构建命令中。

问题表现

当开发者在devcontainer.json中直接使用image属性指定基础镜像（如mcr.microsoft.com/devcontainers/base:jammy）时，执行"Rebuild Container Without Cache"操作后，通过查看远程容器日志可以发现，docker buildx build命令中缺少了关键的--no-cache参数。这导致Docker仍然使用缓存层，特别是容器特性(features)不会被重新构建和更新。

技术分析

深入分析问题根源发现，在Remote-Containers扩展的构建逻辑中，当使用BuildKit构建时（通过buildx命令），虽然构建系统接收到了buildNoCache标志，但该标志并未被正确转换为--no-cache构建参数。这种情况仅发生在直接使用镜像而非Dockerfile的场景中。

临时解决方案

开发者可以采用以下临时解决方案：

1. 将直接指定的镜像转换为Dockerfile形式
2. 创建简单的Dockerfile，如：

FROM mcr.microsoft.com/devcontainers/base:jammy

3. 修改devcontainer.json，将image属性替换为build配置：

"build": {
  "dockerfile": "Dockerfile"
}

官方修复

该问题已在Dev Containers CLI的PR #790中得到修复。验证表明，在预发布版本v0.364.0中，构建命令已正确包含--no-cache参数。修复的核心是在构建命令生成逻辑中，当检测到buildNoCache标志为true时，确保添加--no-cache参数到构建命令数组中。

最佳实践建议

对于依赖容器特性的项目，建议开发者：

1. 始终通过Dockerfile方式引用基础镜像
2. 定期检查Remote-Containers扩展更新
3. 对于关键构建，手动验证是否真正禁用了缓存
4. 在团队协作环境中统一构建工具版本

这个问题提醒我们，在使用高级构建工具时，需要理解其底层实现机制，特别是在涉及缓存等优化功能时，要确保它们按预期工作。