0

0

VSCode如何连接Docker容器 VSCode远程容器开发配置教程

星夢妙者

星夢妙者

发布时间:2025-07-19 20:52:01

|

751人浏览过

|

来源于php中文网

原创

vscode连接docker容器可通过remote - containers插件实现,具体步骤如下:1. 安装remote - containers插件,打开vscode扩展界面搜索并安装;2. 确保docker已安装且容器运行,可使用docker run启动测试容器;3. 选择连接方式:attach to running container用于临时调试已有容器,或open folder in container用于长期开发,后者需创建.devcontainer配置文件定义环境;4. 注意权限、端口映射、网络及性能问题,合理配置可提升体验。整个流程操作清晰,适合统一开发环境。

VSCode如何连接Docker容器 VSCode远程容器开发配置教程

VSCode 连接 Docker 容器其实并不复杂,主要是借助官方提供的 Remote - Containers 插件来实现。这套配置适合需要在容器中开发、调试,同时又不想频繁切换环境的用户。下面我从几个关键点出发,说说怎么配置和使用。

VSCode如何连接Docker容器 VSCode远程容器开发配置教程

安装 Remote - Containers 插件

VSCode 本身并不自带连接容器的功能,你需要先安装 Remote - Containers 插件。这个插件是微软官方出的,功能稳定,使用广泛。

安装方法很简单:

VSCode如何连接Docker容器 VSCode远程容器开发配置教程
  • 打开 VSCode,点击左侧的扩展图标(或按 Ctrl+Shift+X
  • 搜索 Remote - Containers
  • 点击安装

安装完成后,你就能看到一个新的远程连接按钮(左下角),点击后可以选择连接到容器。


准备好 Docker 容器环境

在连接之前,确保你的本地或远程机器上已经安装好了 Docker,并且容器已经启动。如果你还没准备好容器,可以先用 docker run 启动一个测试用的容器,例如:

VSCode如何连接Docker容器 VSCode远程容器开发配置教程
docker run -it --name mydev ubuntu bash

这样就创建并进入了一个 Ubuntu 容器。注意,为了让 VSCode 能连接进去,容器最好保持运行状态,且系统中要有基础的 shell 环境(如 bash)和一些常用工具(如 git、curl 等)。

Manus
Manus

全球首款通用型AI Agent,可以将你的想法转化为行动。

下载

用 VSCode 连接容器的两种方式

连接容器主要有两种方式,分别是:

  • Attach to Running Container:连接已有的正在运行的容器
  • Open Folder in Container:用 .devcontainer 配置文件,把某个项目目录挂载进一个新的容器中开发

Attach to Running Container

这种方式适合临时连接一个已有容器查看或调试。操作步骤如下:

  1. 在 VSCode 左下角点击远程连接按钮
  2. 选择 Remote-Containers: Attach to Running Container
  3. 从列表中选择你要连接的容器
  4. VSCode 会自动在容器中安装一个轻量的 vscode server,然后打开一个新的窗口连接进去

这种方式适合快速进入容器查看文件、运行命令等,但不适合长期开发。

Open Folder in Container

这是更推荐的方式,适合长期开发项目。你需要在项目根目录下创建一个 .devcontainer 文件夹,里面包含 Dockerfiledevcontainer.json 文件,用于定义开发环境。

举个简单的例子:

  1. 在项目根目录下新建 .devcontainer/devcontainer.json 文件
  2. 内容大致如下:
{
  "build": {
    "dockerfile": "Dockerfile"
  },
  "customizations": {
    "vscode": {
      "extensions": ["ms-python.python"]
    }
  }
}
  1. 然后在 VSCode 中打开这个文件夹,点击提示“Reopen in Container”,VSCode 就会自动构建一个容器,并把项目挂载进去

这种方式的好处是环境统一、可复用,而且可以配置默认安装的插件和依赖。


一些常见问题和注意事项

  • 权限问题:容器中运行的用户可能和你本地不一致,导致某些文件权限出错。可以在 devcontainer.json 中配置 "remoteUser": "root" 或者自定义用户。
  • 端口映射:如果你的项目需要访问本地端口(比如 8080),记得在 devcontainer.json 中配置 "appPort": [8080]
  • 网络问题:如果容器需要访问外部网络,或者和其他容器通信,记得在构建时指定合适的网络模式
  • 性能问题:挂载本地文件夹到容器中,有时会影响性能,特别是 macOS 和 Windows 上。可以考虑使用 codespaces 或者 WSL2 提升性能

基本上就这些。整个过程不算太复杂,但有些细节容易忽略,比如权限、端口映射、用户配置等。只要按照步骤一步步来,一般都能顺利连接上容器进行开发。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

419

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数据方法,阅读专题下面的文章了解更多详细内容。

77

2025.09.10

curl_exec
curl_exec

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

440

2023.06.14

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

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

178

2023.10.30

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

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

724

2023.07.05

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

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

556

2023.07.06

java入门学习合集
java入门学习合集

本专题整合了java入门学习指南、初学者项目实战、入门到精通等等内容,阅读专题下面的文章了解更多详细学习方法。

1

2026.01.29

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 3.6万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.3万人学习

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

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