无需VSCode，如何通过终端命令基于devcontainer.json配置构建Docker容器？

核心方案：使用官方devcontainer CLI工具 #

微软官方提供了独立于VSCode的devcontainer命令行工具，完全兼容现有devcontainer.json和Dockerfile配置，能直接通过控制台完成镜像构建、容器启动与挂载，完美匹配你的需求。

步骤1：安装devcontainer CLI

在Ubuntu环境下，通过npm安装（需先安装Node.js）：

npm install -g @devcontainers/cli

也可以直接下载预编译二进制包，解压后加入系统PATH即可使用。

步骤2：基于现有配置构建并启动容器

• 构建镜像：CLI会自动读取devcontainer.json中的context、dockerfile等配置，解决你之前遇到的COPY路径冲突问题：

  devcontainer build --workspace-folder .
  

  这里的.是包含.devcontainer目录的项目根路径。

• 启动容器并进入控制台：

  # 启动容器（自动处理挂载、工作目录、postCreateCommand等配置）
  devcontainer up --workspace-folder .
  # 进入容器终端
  devcontainer exec --workspace-folder . /bin/bash
  

  启动后，本地项目目录会自动挂载到devcontainer.json中workspaceFolder指定的路径，且默认工作目录也会切换到该路径。

手动Docker命令方案（无需额外安装工具） #

如果团队成员不想安装CLI，也可以手动通过Docker命令复用现有配置，只需对应devcontainer.json的参数：

1. 构建镜像：根据devcontainer.json中的context和dockerfile路径执行构建：

   # 假设.devcontainer目录下的devcontainer.json配置了"context": ".."、"dockerfile": "Dockerfile"
   docker build -t dev-project-image -f .devcontainer/Dockerfile ..
   

2. 启动并进入容器：手动挂载本地目录、设置工作目录，对应devcontainer.json的workspaceFolder配置：

   docker run -it --rm \
     -v $(realpath ..):/workspaces/repo \  # 挂载本地项目根目录到容器内的工作目录
     -w /workspaces/repo \  # 设置默认工作目录
     dev-project-image \
     /bin/bash
   

   若devcontainer.json中有runArgs（如端口映射、环境变量），直接追加到命令后即可。

统一配置的注意事项 #

• 分工明确：将镜像构建相关的逻辑（如安装依赖、设置系统环境）放在Dockerfile中；容器运行时配置（挂载路径、工作目录、用户权限、初始化命令）放在devcontainer.json中，确保两种环境的一致性。
• 对齐工作目录：确保devcontainer.json的workspaceFolder与Dockerfile中WORKDIR的路径一致，避免终端进入容器后工作目录混乱。
• 复用初始化命令：devcontainer.json中的postCreateCommand会被CLI自动执行，无需在Dockerfile或手动命令中重复编写项目初始化逻辑。

内容的提问来源于stack exchange，提问作者leeamtlrd