开发容器环境对齐工作流

概述

本地与 CI 工具版本不一致，是“在我机器上能跑”的常见根源。把工具版本在开发容器中与 CI 对齐、用 compose 提供数据库等依赖、挂载缓存保持启动迅速，并以干净克隆在容器内构建测试来证明一致性，可显著缩短上手时间。

关键步骤

1. 在开发容器中固定与 CI 一致的工具版本。
2. 通过 compose 提供数据库等支撑服务。
3. 为包管理器挂载缓存以加快启动。
4. 验证干净克隆可在容器内构建并测试。

验证

• 干净克隆在容器内跑通构建与测试。
• 工具版本与 CI 相同。
• 依赖服务在本地可用。
• 有容器使用与主机前提文档。

决策点

应用需要数据库或队列时用 compose，否则单容器足够；为加快编辑循环宜绑定挂载源码。

适用范围

本条目围绕「开发容器环境对齐工作流」给出可复制的步骤、验证方式与常见问题，适合需要按此流程落地的工程团队。执行时请结合自身上下文调整命令与阈值，并在变更前后留存证据，便于后续复核与回滚。

{
  "image": "mcr.microsoft.com/devcontainers/typescript-node:22",
  "features": { "ghcr.io/devcontainers/features/docker-in-docker:2": {} },
  "postCreateCommand": "pnpm install"
}