VSCode配置Docker开发环境(详细图解，容器开发入门)-VSCode-PHP中文网

VSCode配置Docker开发环境(详细图解，容器开发入门)

蓮花仙者

发布： 2025-08-14 19:44:02

原创

965人浏览过

答案：通过在VSCode中配置Docker开发环境，可实现代码在容器中运行与调试，确保环境一致性，提升开发效率；首先安装Docker和VSCode的Docker扩展，创建Dockerfile定义镜像，构建镜像并使用docker-compose.yml管理多服务，通过Remote-Containers扩展连接容器，在容器中开发；优化Dockerfile可通过利用缓存、多阶段构建和减小镜像大小来提升构建速度；调试时配置launch.json并启用Node.js调试模式，实现断点调试；端口冲突可通过检查占用、修改映射、使用动态端口或停止冲突服务解决。

vscode配置docker开发环境(详细图解，容器开发入门)

直接在VSCode中配置Docker开发环境，意味着你可以告别本地环境配置的各种坑，直接在容器里跑你的代码，调试也更方便，而且环境一致性也能得到保障。简单来说，就是把你的开发环境“装”进一个容器里，随处运行，妈妈再也不用担心我的代码在别人电脑上跑不起来了！

配置Docker开发环境

首先，确保你已经安装了Docker和VSCode。然后，我们需要安装VSCode的Docker扩展。

安装VSCode Docker扩展: 打开VSCode，点击左侧的扩展图标，搜索“Docker”，安装Microsoft官方的Docker扩展。
连接Docker: 扩展安装完成后，VSCode左侧会多出一个Docker图标。点击它，如果Docker正在运行，你应该能看到本地的容器和镜像。如果没有，检查Docker是否已启动。
创建Dockerfile: 在你的项目根目录下创建一个名为
```
Dockerfile
```
登录后复制
的文件。这个文件定义了你的Docker镜像的内容。一个简单的Node.js应用的Dockerfile可能如下所示：
```
FROM node:16-alpine

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

EXPOSE 3000

CMD ["npm", "start"]
```
登录后复制
这个Dockerfile做了什么？
- ```
FROM node:16-alpine
```
  登录后复制
  ：基于Node.js 16的Alpine Linux镜像构建。Alpine体积小，适合作为基础镜像。
- ```
WORKDIR /app
```
  登录后复制
  ：设置工作目录为/app。
- ```
COPY package*.json ./
```
  登录后复制
  ：复制package.json和package-lock.json到工作目录。
- ```
RUN npm install
```
  登录后复制
  ：安装依赖。
- ```
COPY . .
```
  登录后复制
  ：复制所有项目文件到工作目录。
- ```
EXPOSE 3000
```
  登录后复制
  ：暴露3000端口。
- ```
CMD ["npm", "start"]
```
  登录后复制
  ：运行npm start命令。
构建Docker镜像: 在VSCode的终端中，进入项目根目录，运行以下命令构建镜像：
```
docker build -t my-node-app .
```
登录后复制
```
-t my-node-app
```
登录后复制
给镜像打上标签，
```
.
```
登录后复制
表示Dockerfile在当前目录。
创建docker-compose.yml (可选但推荐): 如果你的应用依赖多个服务（比如数据库），可以使用docker-compose.yml来管理。一个简单的例子：
```
version: "3.9"
services:
  app:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - .:/app
    environment:
      NODE_ENV: development
```
登录后复制
这个docker-compose.yml文件定义了一个名为
```
app
```
登录后复制
的服务，它基于当前目录下的Dockerfile构建，将主机的3000端口映射到容器的3000端口，并将当前目录挂载到容器的/app目录。
```
NODE_ENV: development
```
登录后复制
设置环境变量。
运行Docker容器: 如果你使用了docker-compose.yml，运行以下命令：
```
docker-compose up -d
```
登录后复制
```
-d
```
登录后复制
表示在后台运行。如果没有使用docker-compose.yml，运行：
```
docker run -p 3000:3000 my-node-app
```
登录后复制
```
-p 3000:3000
```
登录后复制
将主机的3000端口映射到容器的3000端口。
VSCode Remote - Containers: 安装Remote - Containers扩展后，VSCode可以连接到Docker容器。在VSCode中，按下
```
Ctrl+Shift+P
```
登录后复制
(或者
```
Cmd+Shift+P
```
登录后复制
在Mac上)，输入“Remote-Containers: Attach to Running Container...”，选择你的容器。
在容器中开发: 现在，你的VSCode已经连接到Docker容器。你可以在VSCode中编辑代码，并在容器中运行和调试。任何对代码的修改都会立即反映在容器中，因为我们使用了volume挂载。

如何优化Dockerfile以提高构建速度？

镜像构建速度慢是使用Docker常见的问题。优化Dockerfile可以显著提高构建速度。

PHP 网络编程技术与实例(曹衍龙)

PHP网络编程技术详解由浅入深，全面、系统地介绍了PHP开发技术，并提供了大量实例，供读者实战演练。另外，笔者专门为本书录制了相应的配套教学视频，以帮助读者更好地学习本书内容。这些视频和书中的实例源代码一起收录于配书光盘中。本书共分4篇。第1篇是PHP准备篇，介绍了PHP的优势、开发环境及安装；第2篇是PHP基础篇，介绍了PHP中的常量与变量、运算符与表达式、流程控制以及函数；第3篇是进阶篇，介绍

386

查看详情

利用缓存: Docker会缓存每一层的构建结果。如果Dockerfile中的某一层没有发生变化，Docker会直接使用缓存，而不是重新构建。因此，应该把不经常变化的层放在前面，经常变化的层放在后面。例如，先把package.json复制进去安装依赖，再复制源代码。
使用多阶段构建: 多阶段构建允许你在一个Dockerfile中使用多个FROM语句。每个FROM语句定义一个新的构建阶段。你可以从一个阶段复制文件到另一个阶段，而不需要把所有文件都放在最终镜像中。例如，你可以在一个阶段中构建前端代码，然后把构建好的静态文件复制到另一个阶段的Nginx镜像中。
减少镜像大小: 镜像体积越小，下载和运行速度越快。可以使用
```
.dockerignore
```
登录后复制
文件排除不必要的文件，例如node_modules。选择更小的基础镜像，例如Alpine Linux。

如何在Docker容器中调试代码？

调试容器内的代码可能会有点棘手，但VSCode的Remote - Containers扩展提供了方便的调试功能。

配置launch.json: 在VSCode中，点击调试图标，创建一个
```
.vscode/launch.json
```
登录后复制
文件。根据你的项目类型，选择合适的调试配置。例如，如果你的应用是Node.js应用，可以选择“Node.js: Attach to Process”。

修改launch.json: 修改

launch.json

登录后复制

文件，使其连接到容器内的进程。你需要指定容器的IP地址和端口。如果你的应用监听的是3000端口，可以这样配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Process",
      "port": 9229, // Node.js 调试端口
      "address": "localhost",
      "remoteRoot": "/app", // 容器内的代码根目录
      "localRoot": "${workspaceFolder}" // 本地代码根目录
    }
  ]
}

登录后复制

确保你的Node.js应用在启动时启用了调试模式。例如，可以使用

node --inspect=0.0.0.0:9229 index.js

登录后复制

启动应用。

开始调试: 点击调试图标，选择你配置的调试配置，开始调试。现在，你可以在VSCode中设置断点，单步执行代码，查看变量的值，就像在本地调试一样。

如何解决Docker容器端口冲突问题？

端口冲突是使用Docker时常见的问题。当多个容器或主机上的服务尝试使用同一个端口时，就会发生冲突。

检查端口占用: 使用
```
netstat -tulnp
```
登录后复制
命令 (Linux) 或
```
Get-Process -Id (Get-NetTCPConnection -LocalPort <port>).OwningProcess
```
登录后复制
(Powershell) 检查端口是否被占用。
修改端口映射: 如果端口被占用，修改docker run命令或docker-compose.yml文件中的端口映射。例如，将
```
-p 3000:3000
```
登录后复制
改为
```
-p 8080:3000
```
登录后复制
，将主机的8080端口映射到容器的3000端口。
使用动态端口: 可以使用动态端口，让Docker自动分配一个可用的端口。在docker run命令中使用
```
-P
```
登录后复制
选项，Docker会随机分配一个49153-65535之间的端口。
停止冲突的容器或服务: 如果端口被其他容器或服务占用，停止这些容器或服务。