使用VSCode Dev Containers可在Docker容器中搭建一致开发环境。1. 安装Docker、VSCode及Remote Containers扩展;2. 项目根目录下通过命令面板添加Dev Container配置文件,生成.devcontainer文件夹;3. 配置devcontainer.json指定镜像、端口、插件等,如用Python镜像并自动安装Pylance;4. 点击左下角“Reopen in Container”构建并进入容器环境;5. 可选自定义Dockerfile安装系统依赖,如libpq-dev;6. 遇变更可重建容器,实现团队环境统一,避免“在我机器上正常”问题。

在现代开发中,使用容器化环境可以极大提升协作效率和环境一致性。VSCode 结合 Docker 提供了“Dev Containers”功能,让你在一个隔离的容器中进行开发,同时享受本地编辑器的流畅体验。下面是如何搭建 VSCode 容器化开发环境的完整流程。
1. 环境准备
确保你的系统已安装以下工具:
Docker:负责运行容器环境Visual Studio Code:主编辑器Dev Containers 扩展:VSCode 官方插件(名称为 ms-vscode-remote.remote-containers)
安装完成后,重启 VSCode,你会在左侧活动栏看到一个“>[ ]”图标(Remote Explorer),说明扩展已就绪。
2. 创建 Dev Container 配置文件
打开你的项目文件夹,在 VSCode 中执行以下操作:
按下 F1 或 Ctrl+Shift+P 打开命令面板输入并选择:Remote-Containers: Add Development Container Configuration Files…你可以选择: 从预设模板中选(如 Node.js、Python、Ubuntu 等)或创建一个空配置来自定义
VSCode 会在项目根目录生成一个 .devcontainer/ 文件夹,包含:
devcontainer.json:容器配置,如镜像、端口、挂载等Dockerfile(可选):自定义镜像构建逻辑
3. 配置 devcontainer.json 示例
以下是一个基于 Ubuntu 的 Python 开发环境配置示例:
{ "name": "Python Dev Container", "image": "mcr.microsoft.com/vscode/devcontainers/python:3.11-bullseye", "features": { "git": "os-provided" }, "forwardPorts": [8000, 8080], "postCreateCommand": "pip install --upgrade pip", "remoteUser": "vscode", "customizations": { "vscode": { "extensions": [ "ms-python.python", "ms-python.vscode-pylance" ], "settings": { "python.defaultInterpreterPath": "/usr/local/bin/python" } } }}
说明:
Calliper 文档对比神器
文档内容对比神器
28 查看详情
image:使用微软提供的标准 Python 镜像forwardPorts:自动转发常用服务端口postCreateCommand:容器创建后自动执行的命令extensions:进入容器时自动安装推荐插件
4. 启动容器开发环境
配置完成后:
点击 VSCode 左下角的绿色标签:首次会构建镜像并启动容器,稍等片刻启动成功后,你当前的编辑环境就运行在容器内了
此时你可以在终端中执行 python –version、pip list 等命令,验证环境是否正确。
5. 自定义 Dockerfile(进阶)
若需更复杂的环境(如安装系统依赖),可配置 Dockerfile:
# .devcontainer/DockerfileFROM mcr.microsoft.com/vscode/devcontainers/python:3.11-bullseye安装系统包
RUN apt-get update && export DEBIAN_FRONTEND=noninteractive && apt-get -y install --no-install-recommends libpq-dev gcc
设置工作目录
WORKDIR /workspace
然后在 devcontainer.json 中改为使用 dockerFile 字段:
"build": { "dockerfile": "Dockerfile"}
6. 常见问题与技巧
权限问题:建议设置 remoteUser: vscode 避免 root 操作文件挂载:项目目录默认挂载到容器内,修改实时同步离线重连:关闭 VSCode 后容器可能暂停,重新打开会自动恢复重建容器:配置变更后,可通过命令面板选择“Rebuild Container”
基本上就这些。用好 Dev Containers,团队成员不再需要“在我机器上是好的”这种尴尬。统一环境,开箱即用,开发体验更干净、更可控。
以上就是VSCode容器:Docker开发环境搭建的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/558339.html
微信扫一扫
支付宝扫一扫