VS Code Dev Containers postCreateCommand 的一次性初始化配置方法

VS Code Dev Containers 要在容器首次创建完成后安装依赖、生成配置或执行一次初始化，最直接的做法是在 .devcontainer/devcontainer.json 中写入 postCreateCommand。它和每次启动都执行的 postStartCommand 不是一回事，先分清生命周期，重建后才能判断结果。

官方地址：https://code.visualstudio.com/

在 devcontainer.json 写入一次性初始化命令

在 VS Code 资源管理器打开 .devcontainer/devcontainer.json，找到与镜像、扩展同级的配置位置。下面示例把依赖安装和初始化脚本拆开写，便于失败时定位；这是严格 JSON，不能加入注释，所以把字段含义放在代码块旁说明。

{
  "name": "go-workspace",
  "image": "mcr.microsoft.com/devcontainers/go:1-1.25-bookworm",
  "postCreateCommand": "bash .devcontainer/setup.sh"
}

把复杂逻辑放进 setup.sh，脚本中用中文注释说明目的，并用可重复执行的命令避免重建时产生脏状态：

#!/usr/bin/env bash
set -euo pipefail

# 安装项目依赖；每次重建都能安全重复执行
go mod download
# 创建开发配置目录；已存在时不报错
mkdir -p .cache/dev
echo "初始化完成：依赖已准备"

重新创建容器让配置真正生效

1. 按 F1（macOS 为 ⇧⌘P）打开命令面板。
2. 输入并选择 Dev Containers: Rebuild Container。
3. 等待容器重新创建，在“终端 → 新建终端”打开容器终端。

只保存 devcontainer.json 不代表旧容器已经执行新命令。重建完成后，终端应能看到脚本的“初始化完成”提示，并且工作区内出现预期的 .cache/dev 目录。这个状态只能说明创建阶段执行过，不能推断每次启动都会执行。

用执行时机区分两个生命周期钩子

如果服务需要在每次打开项目时启动，就把它移到 postStartCommand；如果命令会重复写文件、重复创建用户或重复占用端口，就先在脚本中加入存在性判断。初始化脚本失败时，优先看命令面板和容器终端的具体报错，不要只反复重建。

常见问题

为什么修改后没有看到命令执行？

通常是只保存了配置但没有 Rebuild。重新创建容器后再看容器终端，旧容器不会自动补跑新的创建钩子。

postCreateCommand 能不能启动常驻服务？

可以启动，但它只绑定创建阶段；需要每次启动都运行的服务应改用 postStartCommand，并处理重复启动。

命令写成字符串还是数组？

简单命令用字符串即可；参数边界需要更清楚时可按官方字段格式改用数组，但核心仍是选择正确的生命周期。