devcontainer.json 中 extensions 字段不生效的主因是容器缺失 vscode-server 或无法访问 marketplace；需确保基础镜像含 curl/tar、正确配置代理、使用准确扩展 id，并显式声明所有扩展，禁用 syncextensions。
devcontainer.json 里 extension 字段不生效？检查安装位置和网络环境
VSCode 在容器内安装扩展，本质是让 Remote-Containers 扩展在容器启动时自动执行 code --install-extension。但很多人写完 "extensions": ["ms-python.python"] 后发现插件没装上——常见原因是容器内没预装 VS Code Server（即 vscode-server），或容器无法访问 Marketplace（比如内网、代理未配置）。
实操建议：
- 确认基础镜像是否含
curl和tar（vscode-server安装依赖）；精简镜像如python:3.11-slim默认不含，需手动apt-get update && apt-get install -y curl tar - 若用公司代理，必须在
devcontainer.json中通过"runArgs"传入环境变量："runArgs": ["-e", "HTTP_PROXY=http://host.docker.internal:8080", "-e", "HTTPS_PROXY=http://host.docker.internal:8080"] - 扩展 ID 必须准确，比如 Pylance 是
ms-python.vscode-pylance，不是ms-python.pylance；可在 VS Code 扩展页 URL 末尾看到真实 ID
本地扩展同步到容器？别依赖 syncExtensions —— 容器内无 UI 环境
"syncExtensions": true 只在远程 SSH 或 Codespaces 生效，对 Dev Container **完全无效**。它依赖宿主机 VS Code 的 Extension Host 进程，而容器内运行的是 headless 的 vscode-server，不支持动态加载本地已安装的扩展包。
正确做法是显式声明所有必需扩展：
- 把开发所需扩展全部列在
devcontainer.json的"extensions"数组里，例如：["ms-python.python", "esbenp.prettier-vscode", "redhat.vscode-yaml"] - 避免用
"extensions": ["*"]或留空——这不会继承宿主机配置，只会跳过安装 - 如需调试扩展本身，得额外挂载源码并用
"extensionKind": ["ui", "workspace"]控制加载时机
扩展安装后不生效？检查容器重启方式与 volume 挂载
扩展实际安装路径是 /root/.vscode-server/extensions/（root 用户）或 /home/vscode/.vscode-server/extensions/（非 root）。如果每次重建容器都丢失扩展，大概率是 .vscode-server 目录没持久化。
关键配置点：
- 确保
devcontainer.json中没有覆盖"workspaceFolder"导致路径错乱；默认工作区挂载到/workspaces/xxx，不影响扩展路径 - 若用自定义用户（如
"remoteUser": "dev"），必须保证该用户对/home/dev/.vscode-server有读写权限，否则安装会静默失败 - 不要在
"postCreateCommand"里手动调用code --install-extension：此时vscode-server还未初始化，命令会报command 'code' not found
离线环境安装扩展？提前下载 VSIX 并用 installExtension 脚本
内网或断网场景下，Marketplace 不可达，"extensions" 字段直接失效。必须改用本地 VSIX 文件 + postStartCommand 安装。
操作流程：
- 在可联网机器上用
code --install-extension ms-python.python --force --user-data-dir /tmp/test触发下载，然后从~/.vscode/extensions/找到对应 VSIX（或用https://marketplace.visualstudio.com/items?itemName=ms-python.python&ssr=false#version-history下载） - 把 VSIX 文件放进项目目录，例如
.devcontainer/python-2024.12.0.vsix - 在
devcontainer.json中添加："postStartCommand": "code --install-extension .devcontainer/python-2024.12.0.vsix --force" - 注意：VSIX 必须与容器内
vscode-server版本兼容，可用code --version查看宿主机 VS Code 版本，再查对应vscode-server发布页匹配
最易被忽略的一点：扩展安装成功不代表功能就绪。比如 Python 扩展依赖 python 命令在 PATH 中，而某些基础镜像只装了 python3；这时得在 postCreateCommand 里加软链，否则调试器、linter 全部报错。
