VSCode不自动安装依赖，团队需通过devcontainer.json的postCreateCommand实现“打开即装”，如"npm ci"或"pip install -r requirements.txt"，并确保Remote-Containers扩展和Docker已就绪。
VSCode 本身不自动安装项目依赖，团队协作中依赖同步靠的是标准化配置 + 明确的触发动作，不是“打开就装”。关键在让 npm install、mvn clean install 或 pip install -r requirements.txt 这类命令能在所有成员机器上稳定、一致地执行。
devcontainer.json 是最可靠的自动安装入口
容器环境天然隔离、可复现，devcontainer.json 中的 postCreateCommand 是唯一被 VSCode 官方支持的“打开即装”机制。
- 必须把依赖安装命令写进
postCreateCommand，例如："postCreateCommand": "npm ci"（比npm install更确定）或"pip install --no-cache-dir -r requirements.txt" - 不要用
postStartCommand：它在容器已启动后才运行，此时 VSCode 可能已加载旧缓存，类型提示仍报错 - 确保
.devcontainer/devcontainer.json提交到仓库——这是团队共享的“环境合约”，不是个人配置 - 基础镜像要带构建工具：Node.js 项目选
mcr.microsoft.com/vscode/devcontainers/javascript-node:18，别用纯node:18-slim，否则缺git或python3会导致postCreateCommand失败
package.json / pom.xml / pyproject.toml 必须真实有效
VSCode 不解析模糊配置，所有依赖声明必须满足工具链原生要求，否则 postCreateCommand 会静默失败。
-
package.json里不能只有devDependencies却漏掉dependencies，否则npm ci跳过安装运行时依赖 - Maven 项目必须有可执行的
pom.xml，且<packaging>是jar或war；<packaging>pom</packaging>的父 POM 不会触发依赖下载 - Python 项目若用
poetry，postCreateCommand得写成poetry install，且镜像需预装poetry，不能只靠pip install poetry—— 那会破坏 Docker 层缓存 - 检查
package-lock.json、poetry.lock或maven-metadata-local.xml是否被.dockerignore错误排除——它们是安装确定性的关键
本地开发时，别依赖“自动”，而要明确触发时机
没有容器时，VSCode 不会在你打开文件夹那一刻执行 npm install。所谓“自动”其实是人设定了固定动作，并靠文档/脚本/约定来驱动。
- 在根目录放一个
setup.sh（macOS/Linux）或setup.bat（Windows），内容就是npm ci && npm run build，并在README.md里写明“首次打开请先运行” - 用 VSCode 的
tasks.json定义一个setup任务，绑定快捷键（如Ctrl+Shift+P→Tasks: Run Task→setup），避免成员记错命令 - 禁用任何“保存时自动安装”的插件——这类行为不可控、易冲突，且无法审计。VSCode 的
editor.codeActionsOnSave不处理依赖安装，只管 import 整理 - 如果团队混用 Windows/macOS/Linux，避免在脚本里写死路径分隔符，改用
cross-env或 shell 内置变量（如$PWD）
真正容易被忽略的是：即使 devcontainer.json 配得再完美，只要某位成员本地没装 Remote - Containers 扩展，或者 Docker Desktop 没运行，整个自动流程就卡在第一步。这不是配置问题，是协作前提没对齐——所以 CONTRIBUTING.md 里第一行该写清楚“必需工具清单”，而不是藏在某个子章节里。
