关键在devcontainer.json三个硬性配置：containeruser必须设为镜像中真实存在的非root用户（如"vscode"），否则vscode server无法启动；forwardports生效前提是服务监听0.0.0.0而非127.0.0.1；customizations.vscode.extensions必须显式声明容器内所需插件id（如"ms-python.python"），否则调试、格式化等功能失效。
远程容器开发不是“连上容器就行”，关键在 devcontainer.json 里三个硬性配置：用户权限、监听地址、插件列表——漏掉任意一个，就会卡在终端打不开、断点不生效、保存不格式化。
containerUser 必须显式设为镜像里真实存在的非 root 用户
官方 Python 镜像（如 python:3.11）默认只有 root，但 VSCode Server 进程必须以普通用户身份运行，否则：
• /home/vscode/.vscode-server 目录无法创建或写入
• 挂载进来的项目目录属主变成 root:root，你在本地改不了文件、git commit 报错
• 终端一打开就闪退，日志里出现 Permission denied: /home/vscode
- 用官方基础镜像时，加这一行：
"containerUser": "vscode" - 用自定义
Dockerfile时，必须显式创建用户：RUN useradd -m -u 1001 -G sudo vscode && chown -R vscode:vscode /home/vscode -
remoteUser是无效的——它只影响你手动打开的终端，不解决 VSCode Server 自身的启动权限问题
forwardPorts 生效的前提是服务监听 0.0.0.0，不是 127.0.0.1
配了 "forwardPorts": [5000] 却在浏览器打不开 localhost:5000？90% 是因为 Flask/FastAPI/Spring Boot 默认只绑 127.0.0.1:5000，容器内其他进程（包括 VSCode 的转发代理）根本连不上。
- Flask：
app.run(host='0.0.0.0', port=5000) - FastAPI：
uvicorn.run(app, host="0.0.0.0", port=8000) - 验证方式：进容器终端执行
netstat -tuln | grep :5000，看到0.0.0.0:5000才算对 - 别信“本地能跑就行”——容器网络隔离下，
127.0.0.1在容器里只指向自己，不对外暴露
customizations.vscode.extensions 必须填容器内要装的插件 ID
你在本地装了 ms-python.python，不代表容器里有 Python 调试器。Remote-Containers 是两套独立环境：本地只管 UI，所有语言服务器、调试器、格式化工具都跑在容器里。
- 漏掉
ms-python.python→ F5 调试按钮灰掉、launch.json生成失败 - 漏掉
esbenp.prettier-vscode→ 保存不自动格式化、formatOnSave无效 - 插件装在容器内路径：
/home/vscode/.vscode-server/extensions/，不是本地~/.vscode/extensions/ - 示例写法：
"customizations": { "vscode": { "extensions": ["ms-python.python", "esbenp.prettier-vscode"] } }
最常被跳过的细节是：containerUser 和 customizations.vscode.extensions 必须同时存在且正确——前者决定进程能不能起来，后者决定起来之后能不能干活。改完 devcontainer.json 一定要重新 Build & Reopen in Container，热重载不生效。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
