0

0

VSCode怎样使用Docker进行容器化开发【教程】

夜晨

夜晨

发布时间:2026-01-25 19:53:02

|

503人浏览过

|

来源于php中文网

原创

VSCode 本身不运行 Docker,但通过官方 Remote - Containers 扩展可实现在容器内开发、调试与运行;需先安装 Docker 引擎,卸载非必要 Docker 类插件,重启后状态栏显示连接标识。

vscode怎样使用docker进行容器化开发【教程】

VSCode 本身不运行 Docker,但通过 Remote - Containers 扩展可以真正实现“在容器里写代码、调试、运行”,不是简单调个 docker run 就完事——关键在于开发环境与运行环境的一致性是否闭环。

装对扩展:只认 Remote - Containers,别被其他 Docker 插件带偏

VSCode 市场里有十几个带 “Docker” 字样的扩展,但只有官方的 Remote - Containers(由 Microsoft 发布)能让你把整个工作区打开进一个正在运行的容器中。它依赖本地已安装的 Docker 引擎,不自带 Docker,也不模拟容器。

  • 必须先在系统上装好 Docker Desktop(macOS/Windows)或 docker-ce(Linux),且能正常执行 docker ps
  • 卸载掉名字含 Docker ExplorerDocker Extension Pack 等纯管理类插件——它们只能看镜像、启停容器,不能接管开发会话
  • 安装后重启 VSCode,右下角状态栏会出现 > 图标,悬停提示 “Reopen in Container”

.devcontainer/devcontainer.json 是核心配置,不是可选文件

这个 JSON 文件定义了容器怎么起、装什么、端口怎么映射、环境变量怎么设。没有它,VSCode 就不知道该用哪个镜像、要不要挂卷、是否自动安装扩展。它比 docker-compose.yml 更聚焦“开发态”而非“部署态”。

拍客piikee竞拍系统
拍客piikee竞拍系统

拍客竞拍系统是一款免费竞拍网站建设软件,任何个人可以下载使用,但未经商业授权不能进行商业活动,程序源代码开源,任何个人和企业可以进行二次开发,但不能以出售和盈利为目的。安装方法,将www文件夹里面的所有文件上传至虚拟主机,在浏览器执行http://你的域名/install.php或者直接导入数据库文件执行。本次升级优化了一下内容1,程序和模板完美分离。2,优化了安装文件。3,后台增加模板切换功能。

下载
  • imagebuild 二选一:"image": "python:3.11-slim" 直接拉官方镜像;"build": { "dockerfile": "Dockerfile" } 则走自定义构建
  • mounts 字段常被忽略:默认只有当前目录挂进容器的 /workspace,若项目依赖宿主机的 /etc/hosts 或本地数据库 socket,得手动加 "source": "/var/run/docker.sock", "target": "/var/run/docker.sock"
  • forwardPorts 写的是容器内端口(如 8000),VSCode 会自动在宿主机开随机端口并转发,无需自己记 -p 8000:8000
  • 别直接改 docker run 参数——所有配置都走 JSON 字段,比如要加 --cap-add=SYS_PTRACE,用 "runArgs": ["--cap-add=SYS_PTRACE"]

调试 Python/Node.js 时,容器内路径和宿主机路径必须对齐

VSCode 调试器运行在宿主机,但进程跑在容器里。断点能命中、变量能读取的前提是:调试器看到的文件路径(宿主机路径)和容器内解释器加载的路径(容器内路径)能一一映射。否则会显示 “Source code not available” 或跳过断点。

  • 默认情况下,VSCode 把当前工作区路径(如 /Users/me/project)挂载为容器内的 /workspace,所以 launch.json 中的 "program" 必须写成 "${workspaceFolder}/main.py",而不是硬编码绝对路径
  • 如果用了 build + 自定义 Dockerfile,且在镜像里把代码 COPY 到了 /app,那必须同步改 devcontainer.jsonworkspaceFolder 字段为 "/app",否则 VSCode 还以为代码在 /workspace
  • Node.js 项目常见坑:npm install 在容器内执行后,node_modules 存在容器里,但宿主机没这份副本——这没问题;但如果你在宿主机执行 npm start,就会报错,因为根本没进容器

最易被忽略的一点:每次修改 devcontainer.json 后,必须点击右下角的 Reopen in Container(或按 Cmd/Ctrl+Shift+P → Dev Containers: Reopen in Container),而不是 Ctrl+S 保存就生效。VSCode 不会热重载容器配置,旧容器不会自动更新,改了等于白改。

相关专题

更多
windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

709

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1128

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

799

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

454

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2351

2023.08.08

windows自动更新
windows自动更新

Windows操作系统的自动更新功能可以确保系统及时获取最新的补丁和安全更新,以提高系统的稳定性和安全性。然而,有时候我们可能希望暂时或永久地关闭Windows的自动更新功能。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

823

2023.08.10

windows boot manager
windows boot manager

windows boot manager无法开机的解决方法:1、系统文件损坏,使用Windows安装光盘或USB启动盘进入恢复环境,选择修复计算机,然后选择自动修复;2、引导顺序错误,进入恢复环境,选择命令提示符,输入命令"bootrec /fixboot"和"bootrec /fixmbr",然后重新启动计算机;3、硬件问题,使用硬盘检测工具进行扫描和修复;4、重装操作系统。本专题还提供其他解决

1580

2023.08.28

windows锁屏快捷键
windows锁屏快捷键

windows锁屏快捷键是Windows键+L、Ctrl+Alt+Del、Windows键+D、Windows键+P和Windows键+R。本专题为大家提供windows相关的文章、下载、课程内容,供大家免费下载体验。

1636

2023.08.30

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

58

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.8万人学习

Git 教程
Git 教程

共21课时 | 3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号