vscode远程容器开发成败取决于devcontainer.json对containeruser、端口监听地址和插件安装的精准控制：必须设"containeruser":"vscode"确保权限一致，服务需绑定0.0.0.0而非127.0.0.1，customizations.vscode.extensions须显式声明容器内所需插件id。
VSCode 远程容器开发不是“连上容器就行”，成败取决于 devcontainer.json 是否真正控制了用户权限、端口监听地址和插件加载——这三点错一个，就只能看到空白终端或灰掉的调试按钮。
devcontainer.json 放哪儿、字段怎么写才被识别
VSCode 只认固定路径和结构：.devcontainer/devcontainer.json（注意开头的点、是目录不是文件、在你打开的项目根目录下）。写成 devcontainer.json（没点）、.devcontainer.json（是文件）、或者塞进 .vscode/ 里，VSCode 都直接忽略。
"image" 和 "build" 字段不能共存，同时出现会报错：Invalid devcontainer.json: 'image' and 'build' cannot both be specified。
- 用公开镜像（比如
mcr.microsoft.com/vscode/devcontainers/python:3.11）就只配"image" - 要装私有 CLI、预置 SSH key 或改系统 locale，就必须删掉
"image"，只留"build"，并在Dockerfile里FROM那个基础镜像 -
"build": { "context": ".." }这种跨目录引用容易出错：VSCode 构建时工作目录是.devcontainer/，不是项目根目录
为什么终端打不开、插件不生效、文件改不了
根本原因是没设 "containerUser": "vscode"。官方镜像（如 python:3.11）默认只有 root，而 VSCode Server 启动后会以该用户身份写 /home/vscode/.vscode-server ——没这个目录或没写权限，直接报错。
containerUser 决定三件事：VSCode Server 进程归属、挂载进来的项目目录属主、/home/vscode 是否可写。
- 如果用自定义
Dockerfile，必须显式创建用户并设好 home 目录：RUN useradd -m -u 1001 -G sudo vscode && chown -R vscode:vscode /home/vscode -
remoteUser没用：它只影响你手动打开的终端，不解决 VSCode 自身的权限问题 - 别用
root：会导致本地挂载卷文件属主变成root:root，主机上无法直接git commit或编辑
forwardPorts 配好了，但浏览器打不开 localhost:3000
配置了 "forwardPorts": [3000] 却访问失败？大概率是容器内服务绑定了 127.0.0.1:3000，而不是 0.0.0.0:3000。VSCode 的端口转发只是把宿主机请求转发到容器 IP，但容器内服务必须接受来自任意 IP 的连接才能响应。
- Flask：
app.run(host='0.0.0.0', port=5000) - Spring Boot：
server.address=0.0.0.0加到application.properties - 验证方式：进容器终端执行
netstat -tuln | grep :3000，看到0.0.0.0:3000才算对
customizations.vscode.extensions 装的是容器里的插件，不是本地的
你在本地 VSCode 装了 ms-python.python，不代表容器里也有 Python 支持。VSCode Remote-Containers 是两套独立环境：本地负责 UI，容器内运行语言服务器、调试器、格式化工具等全部后端逻辑。
customizations.vscode.extensions 数组里填的插件，会在容器首次启动时自动安装到 /home/vscode/.vscode-server/extensions/。
- 漏掉
ms-python.python→ Python 语法不识别、F5 调试按钮灰掉 - 漏掉
esbenp.prettier-vscode→ 保存不格式化 - 不要依赖本地已装插件，每个要用的都得列在这里
最容易被忽略的是：容器内工具链（比如 conda、nvm）的初始化脚本默认不加载，即使镜像里装了也用不了；还有 postCreateCommand 不显式 source，就会导致 git 命令不可用、pip install --user 失败——这些都不是配置错了，而是启动时根本没触发环境加载逻辑。
