讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

字幕擦除翻译、配音口型同步

updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

VSCode中的Docker支持:容器化开发工作流指南

浅浩吖_3702

浅浩吖_3702

发布时间:2025-12-21 15:38:03

|

493人浏览过

|

来源于php中文网

原创

VSCode中Docker开发失败的五大解决步骤:一、安装启用Docker官方扩展;二、验证Docker Desktop服务运行;三、正确配置.devcontainer/devcontainer.json;四、手动构建镜像并Attach调试;五、修复终端启动问题,如添加--user=root或换用含bash的基础镜像。

如果您在 vscode 中使用 docker 进行开发,但无法启动容器、调试应用或连接到远程容器,则可能是由于扩展配置缺失、docker 服务未运行或 devcontainer.json 设置错误。以下是构建稳定容器化开发工作流的具体步骤:

本文运行环境:MacBook Pro,macOS Sequoia。

一、安装并启用 Docker 扩展

VSCode 的 Docker 支持依赖官方扩展提供图形界面管理、镜像构建和容器调试能力,需确保扩展已正确安装且处于激活状态。

1、打开 VSCode,点击左侧活动栏的扩展图标(或按 Cmd+Shift+X)。

2、在搜索框中输入 Docker,找到由 Microsoft 发布的官方扩展。

3、点击“安装”,安装完成后点击“重新加载”按钮使扩展生效。

二、验证本地 Docker 引擎状态

Docker 扩展无法独立运行,必须依赖宿主机上正在运行的 Docker Desktop 或 Docker Engine 服务,否则所有容器操作将失败。

1、在终端中执行 docker --version,确认 CLI 已安装。

2、执行 docker info,若返回详细信息则说明服务正常;若提示“Cannot connect to the Docker daemon”,则需启动 Docker Desktop。

3、检查 macOS 状态栏右上角是否有 Docker 图标,点击图标并确认显示“Docker Desktop is running”。

三、使用 Dev Container 初始化项目

Dev Container 是 VSCode 容器化开发的核心机制,通过 .devcontainer/devcontainer.json 定义开发环境,实现一键复现一致环境。

1、在项目根目录下创建 .devcontainer 文件夹。

VSCode节点工具(专业版)
VSCode节点工具(专业版)

面向团队的企业级IDE远程操作平台,含调试、测试、终端、Agent委托与团队协作能力。

下载

2、在该文件夹中新建 devcontainer.json,内容至少包含 image 或 dockerfile 字段。

3、按 Cmd+Shift+P 打开命令面板,输入并选择 Dev Containers: Reopen in Container。

四、手动构建并运行容器用于调试

当 devcontainer 自动流程失败时,可绕过扩展直接使用 CLI 构建镜像并运行容器,再通过 VSCode 的 Attach 功能接入调试会话。

1、在项目目录中编写 Dockerfile,确保暴露调试端口(如 9229 用于 Node.js)。

2、执行 docker build -t myapp . 构建镜像。

3、执行 docker run -it --rm -p 3000:3000 -p 9229:9229 -v $(pwd):/workspace myapp 启动容器。

4、在 VSCode 中配置 launch.json,选择 Attach to Node.js Process 类型,并设置 port 为 9229。

五、修复容器内终端无法启动问题

VSCode 在容器中启动集成终端失败,通常因容器缺少 shell 可执行文件或用户权限不足,需调整容器启动参数或基础镜像。

1、修改 devcontainer.json,在 runArgs 中添加 ["--user=root"] 以提升权限。

2、确保基础镜像包含 bash 或 sh,例如使用 node:18-slim 而非 node:18-alpine(后者需额外安装 bash)。

3、在 devcontainer.json 中显式指定 "settings": {"terminal.integrated.defaultProfile.linux": "bash"}。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2395

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3962

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1316

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4599

2025.09.10

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

5136

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1475

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1958

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

10663

2023.08.17

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn