0

0

如何用vscode连接并操作docker容器【教程】

夢幻星辰

夢幻星辰

发布时间:2026-01-25 20:03:09

|

630人浏览过

|

来源于php中文网

原创

不能——VS Code需通过Docker扩展与Remote-Containers扩展协同实现容器连接,后者在容器内启动VS Code Server,前者仅辅助管理镜像和容器。

如何用vscode连接并操作docker容器【教程】

VS Code 能直接连接运行中的容器吗

不能——VS Code 本身不内置容器连接能力,必须通过 Docker 扩展 + Remote - Containers 扩展协同实现。核心逻辑是:先让容器支持 SSH 或挂载 VS Code Server,再由客户端接入。实际最稳定、官方主推的方式是后者,即用 Remote - Containers 在容器内启动一个轻量服务端。

必须安装的两个扩展及其分工

Remote - Containers 是操作主体,负责构建、启动、附加(attach)容器,并在其中部署 VS Code Server;Docker 扩展是辅助,用于浏览镜像、查看日志、手动启停容器——它不参与代码编辑会话。装错或只装一个,都会卡在“找不到容器”或“无法打开文件夹”。

  • 务必从 VS Code 扩展市场安装 ms-vscode-remote.remote-containers(官方 ID),不是第三方同名插件
  • ms-azuretools.vscode-docker 可选,但调试时查日志、看端口映射很实用
  • 二者都依赖本地已安装且正在运行的 dockerd,Windows 用户需确认使用的是 WSL2 后端,而非旧版 Hyper-V

打开容器内项目目录的三种典型路径

不是所有容器都能直接“连上就写代码”。能否成功,取决于容器是否满足 Remote - Containers 的最低运行条件:有 bashgittarcurlwget,且用户有写权限。常见可行方式:

易可图
易可图

电商人都在用的设计平台

下载
  • 从 Dockerfile 重建并附加:右键 .devcontainer/Dockerfile → “Reopen in Container”,VS Code 自动构建镜像、启动容器、挂载当前目录。这是最可控的方式
  • 附加到已有运行中容器:命令面板(Ctrl+Shift+P)→ “Remote-Containers: Attach to Running Container...”,选中目标容器。前提是该容器已预装必要工具,且 /workspaces/root 可写
  • docker-compose.yml 启动:项目根目录放 .devcontainer/docker-compose.yml,内容需包含 volumes 映射和 command 覆盖默认启动行为,否则容器可能一启动就退出

常见失败现象与对应检查点

报错信息往往藏在 Dev Container 日志里(命令面板 → “Remote-Containers: Show Log”),而不是弹窗提示。高频问题集中在环境准备和路径权限:

  • “The container did not start correctly” → 检查容器内是否真有 bash(运行 docker exec -it which bash);若用 Alpine 镜像,需额外安装 bashcurl
  • “Permission denied (publickey)” → 不是 SSH 问题!Remote - Containers 默认不用 SSH,此错误通常因容器内 /root 目录被设为只读,或挂载卷时加了 :ro
  • 编辑器里文件显示为只读、保存失败 → 确认宿主机项目目录对当前用户可写,且容器内用户 UID 匹配(可通过 "remoteUser": "root"devcontainer.json 中临时覆盖)
  • 终端打不开、命令未找到 → 容器内 PATH 未包含 /usr/local/bin 等常用路径,可在 devcontainer.jsonpostCreateCommand 中补全

真正麻烦的从来不是“怎么连”,而是容器环境是否干净、工具链是否齐备、用户权限是否一致——这些细节不提前验证,连上了也写不了几行代码。

相关专题

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

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

417

2023.08.07

json是什么
json是什么

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

535

2023.08.23

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

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

311

2023.10.13

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

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

76

2025.09.10

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

439

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

175

2023.10.30

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

703

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

551

2023.07.06

c++ 根号
c++ 根号

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

51

2026.01.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
go语言零基础开发内容管理系统
go语言零基础开发内容管理系统

共34课时 | 2.6万人学习

第二十三期_前端开发
第二十三期_前端开发

共98课时 | 7.5万人学习

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

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