Dev Containers 并非真正“一键”自动装依赖，因 VSCode 仅在首次打开或手动重建时按 Dockerfile 安装 pip 包；复用缓存镜像会跳过 RUN 步骤，导致 ModuleNotFoundError。
能实现，但“一键式”是假象——真正起作用的是 devcontainer.json + Dockerfile 的组合，且必须手动触发重建才能生效。
为什么不能真的一键启动就自动装好所有依赖？
VSCode 的 Dev Containers 插件不会在每次打开项目时自动重装 pip 依赖。它只会在你首次打开文件夹、或执行 Dev Containers: Rebuild and Reopen in Container 时，才按 Dockerfile 重新构建镜像。如果只是简单地 Reopen in Container，它会复用已缓存的镜像，跳过 RUN pip install 步骤。
- 常见错误现象：
ModuleNotFoundError报错，但requirements.txt明明写了包名——其实是容器没重建，旧镜像里压根没装 - 关键判断点：检查终端里
python -m pip list输出，对比requirements.txt是否一致 - 正确做法：改完
requirements.txt后，必须右键命令面板 → 执行Dev Containers: Rebuild and Reopen in Container
Dockerfile 中安装依赖的顺序很关键
把 COPY requirements.txt 和 RUN pip install 放在 COPY . . 之前，不是为了“规范”，而是为了利用 Docker 构建缓存。只要 requirements.txt 没变，后续构建就能跳过安装步骤，大幅提速。
- 错误写法：
COPY . .在前 → 每次代码改动都会让整个pip install步骤失效，构建慢到无法忍受 - 推荐写法（Python 3.10 示例）：
FROM python:3.10-slim WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY . . CMD ["python", "main.py"]
- 注意：
--no-cache-dir可减少镜像体积；slim镜像不含gcc等编译工具，若依赖含 C 扩展（如numpy、psycopg2），需额外RUN apt-get update && apt-get install -y build-essential
devcontainer.json 必须显式挂载源码并设置路径映射
如果不配置 mounts 或 workspaceFolder，VSCode 会把项目目录以只读方式复制进容器，你改代码根本不会同步回主机，调试也找不到文件。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
- 典型配置项：
{ "name": "Python Dev", "dockerFile": "Dockerfile", "workspaceFolder": "/app", "mounts": [ "source=${localWorkspaceFolder},target=/app,type=bind,consistency=cached" ], "settings": { "python.defaultInterpreterPath": "/usr/local/bin/python" } } -
consistency=cached是 macOS 上必需的，否则文件变更监听极慢；Linux 可省略，Windows WSL2 下建议保留 -
python.defaultInterpreterPath必须指向容器内真实 Python 路径，否则 VSCode 的 IntelliSense 和调试器会找不到解释器
调试时端口和路径映射容易被忽略
用 debugpy 远程调试时，光在 Dockerfile 里 EXPOSE 5678 不够，还得在 devcontainer.json 中开放端口，并在 launch.json 里正确设置 pathMappings。
- 缺
forwardPorts导致断点不命中："forwardPorts": [5678]
-
launch.json中的remoteRoot必须和devcontainer.json的workspaceFolder一致（如都是/app），否则调试器找不到源码位置 - 如果项目结构是
src/main.py，而workspaceFolder是/app，那remoteRoot就不能写成/app/src，否则路径对不上
真正的“全隔离”不在配置多炫酷，而在每次修改依赖后是否记得重建容器、是否验证了 pip list、是否确认了路径映射和端口转发都生效——这些细节不处理，再漂亮的配置也只是摆设。
