vscode本地缓存不管理容器数据，真正起效的是docker层缓存与devcontainer.json的mounts挂载配置；必须用字符串数组格式写--mount语法，指定source（命名卷名或绝对路径）、target（容器内有写权限路径）、type=volume/bind，并同步配置remoteenv环境变量，修改后需“rebuild container”而非仅“reopen”，否则挂载不生效。
VSCode本地缓存本身不管理容器开发数据——真正起作用的是 Docker 层缓存 + devcontainer.json 中的挂载配置。 你看到的“容器每次重启都重装依赖”，问题不在 VSCode 缓存目录（如 %APPDATA%\Code\CachedData），而在 dev container 没有把依赖目录持久化到宿主机。
devcontainer.json 的 mounts 配置写法必须匹配 Docker --mount 语法
在 devcontainer.json 中加挂载，不是写成对象，而是字符串数组，每个字符串必须严格遵循 --mount 格式：
-
source=必须是宿主机绝对路径（Windows 用C:\Users\name\.npm，macOS/Linux 用/Users/name/.npm）或命名卷名（如node_modules_cache） -
target=是容器内路径，且需确保用户有写权限（比如/home/vscode/.npm，不是/root/.npm） -
type=bind表示绑定挂载本地文件夹；type=volume表示使用 Docker 命名卷（推荐用于node_modules、go/pkg等易变但需复用的目录） -
consistency=cached仅 macOS 有效，Windows/WSL2 忽略；不加可能触发文件监听失效（尤其 webpack/hot reload）
错误示例："mounts": [{ "source": "...", "target": "..." }] —— 这是 Docker Compose 的写法，在纯 dockerFile 场景下会静默失败。
挂载 npm 缓存时，remoteEnv 必须同步设置环境变量
只挂载目录不够。Node.js 工具链默认仍会往容器内默认路径写缓存，导致挂载失效。必须显式告诉 npm 使用挂载后的路径：
- 确认挂载目标路径与
remoteEnv中的值一致，例如挂载到/home/vscode/.npm，就要配"NPM_CONFIG_CACHE":"/home/vscode/.npm" - 如果容器用户是
vscode，不要用/root/.npm—— root 用户不可写，npm 会 fallback 到内存缓存，下次启动又重下 - 验证是否生效：进容器执行
npm config get cache，输出必须和target值完全一致
Docker 命名卷比 bind mount 更适合 node_modules 等依赖目录
对 node_modules、venv、~/.m2 这类“内容频繁变更但结构稳定”的目录，优先用命名卷而非 bind mount：
- bind mount 会把宿主机空目录映射进去，首次
npm install后，该目录在宿主机上可见；但若你在宿主机手动删了它，下次容器启动时 npm 会认为目录为空，重新安装 - 命名卷由 Docker 管理，删除容器不会删卷，且不暴露于宿主机文件系统，避免被 IDE 或其他进程意外修改
- 写法示例：
"source=node_modules_cache,target=/workspace/node_modules,type=volume"，无需指定source路径，Docker 自动创建
注意：node_modules_cache 是卷名，不是路径；首次使用时 Docker 会自动初始化，无需提前 docker volume create。
修改 mounts 后必须重建容器，不是重开窗口
很多人改完 devcontainer.json 就 Ctrl+Shift+P → “Reopen in Container”，结果挂载没生效——因为 VSCode 默认复用正在运行的容器实例，而挂载是启动时确定的。
- 正确操作：Ctrl+Shift+P → “Dev Containers: Rebuild Container”（不是 “Reopen”）
- 或者先 “Stop Container”，再 “Reopen in Container”
- 验证是否挂载成功：进容器执行
mount | grep workspace或findmnt -T /workspace/node_modules - 如果看到
node_modules挂载点显示为volume类型，说明命名卷生效；若显示bind且 source 路径是你本地路径，说明 bind mount 成功
最常被忽略的一点：挂载配置只影响容器启动时的文件系统视图，不影响已运行进程的内存状态。比如你正在跑一个 webpack dev server，即使挂载生效，它也不会自动感知新 npm 包——需要手动重启服务。
