---
name: devcontainer 模板同步机制
description: devcontainer 的模板文件（templates/）是单一信源，Dockerfile/post-create.sh 从模板生成运行时文件
type: reference
originSessionId: b34450b8-ed29-4bd1-9d26-88636b7fa9a6
---
devcontainer 文件生成链路：

1. **`templates/runcc.sh`** → `post-create.sh` 复制到 `.volumes/bin/runcc.sh`
2. **`templates/bashrc.tail.sh`** → `Dockerfile` sed 替换 `{{BIN_PATH}}`/`{{NODE_PATH}}` 占位符后追加到 `~/.bashrc`

修改运行时文件时必须同步更新模板，否则下次 `docker build` 会被覆盖。验证方法：`diff templates/X .volumes/X`，占位符替换后应内容一致。