VSCode极简配置Docker：容器管理、中文终端、镜像调试-VSCode-PHP中文网

VSCode极简配置Docker：容器管理、中文终端、镜像调试

雪夜

发布： 2025-08-12 19:28:01

原创

815人浏览过

<ol><li>安装docker、remote - containers及语言包等必要插件；2. 编写dockerfile定义开发环境；3. 配置.devcontainer/devcontainer.json指定构建参数与扩展；4. 使用“reopen in container”命令自动构建并连接容器；5. 通过postcreatecommand解决中文乱码；6. 配置launch.json实现容器内代码调试；7. 优化镜像大小、使用国内源、预构建镜像以解决连接慢问题；8. 利用vscode docker插件管理容器状态、日志、终端与镜像；9. 通过remoteuser、权限调整或volume挂载避免权限问题，从而实现高效便捷的容器化开发。</li></ol>

VSCode极简配置Docker：容器管理、中文终端、镜像调试

VSCode极简配置Docker，核心在于打通开发环境与容器，实现高效调试和管理。简化配置流程，让开发者专注于代码，而非繁琐的环境搭建。

解决方案

安装必备插件：
- Docker: 这个不用多说，官方出品，支持 Docker 命令、镜像管理、容器操作等。
- Remote - Containers: 核心插件，让 VSCode 直接连接到 Docker 容器内部进行开发。
- Chinese (Simplified) Language Pack for VS Code: 如果你需要中文界面，安装它。
- (Optional) Python/Java/Go 等语言支持插件： 根据你的项目语言选择安装，提供语法高亮、代码补全等功能。

编写

Dockerfile

登录后复制

：

FROM ubuntu:latest

# 设置工作目录
WORKDIR /app

# 安装必要的依赖 (以 Python 为例)
RUN apt-get update && apt-get install -y python3 python3-pip

# 复制项目文件到容器
COPY . .

# 安装 Python 依赖
RUN pip3 install -r requirements.txt

# 暴露端口 (如果需要)
EXPOSE 8000

# 启动命令
CMD ["python3", "app.py"]

登录后复制

这个

Dockerfile

登录后复制

只是一个示例，你需要根据自己的项目进行修改。注意：

COPY . .

登录后复制

会将当前目录下的所有文件复制到容器中，如果你的项目很大，可以考虑使用

.dockerignore

登录后复制

文件排除一些不需要的文件。

配置

.devcontainer/devcontainer.json

登录后复制

：

在项目根目录下创建

.devcontainer

登录后复制

文件夹，并在其中创建一个

devcontainer.json

登录后复制

文件。这个文件定义了 VSCode 如何连接到 Docker 容器。

{
    "name": "My Project",
    "build": {
        "dockerfile": "Dockerfile"
    },
    "settings": {
        "terminal.integrated.shell.linux": "/bin/bash" // 设置默认终端为 bash
    },
    "extensions": [
        "ms-python.python", // Python 扩展
        "ms-azuretools.vscode-docker" // Docker 扩展
    ],
    "forwardPorts": [8000] // 端口转发
}

登录后复制

build.dockerfile

登录后复制

指定了

Dockerfile

登录后复制

的路径。

settings

登录后复制

可以设置 VSCode 的一些配置，比如终端。

extensions

登录后复制

指定了需要安装的 VSCode 扩展。

forwardPorts

登录后复制

指定了需要转发的端口。

使用 Remote-Containers 连接到容器：

打开 VSCode，按下
```
Ctrl+Shift+P
```
登录后复制
(Windows/Linux) 或
```
Cmd+Shift+P
```
登录后复制
(macOS)，输入 "Remote-Containers: Reopen in Container" 并选择它。VSCode 会自动构建 Docker 镜像，启动容器，并连接到容器内部。
中文终端问题：

Jenni AI
使用最先进的 AI 写作助手为您的写作增光添彩。

48

查看详情

有时候在容器内部的终端可能会出现中文乱码的问题。可以在
```
devcontainer.json
```
登录后复制
中添加如下配置：
```
"remoteUser": "vscode", // 如果不是 vscode 用户，改成你的用户名
"postCreateCommand": "sudo apt-get update && sudo apt-get install -y locales && sudo locale-gen zh_CN.UTF-8 && sudo update-locale LC_ALL=zh_CN.UTF-8 LANG=zh_CN.UTF-8 && echo 'export LANG=zh_CN.UTF-8' >> ~/.bashrc && echo 'export LANGUAGE=zh_CN.UTF-8' >> ~/.bashrc"
```
登录后复制
这段命令会在容器创建后自动安装中文语言包，并设置环境变量。注意：
```
remoteUser
```
登录后复制
需要改成你的用户名。

镜像调试：

在 VSCode 中，你可以直接调试运行在 Docker 容器中的代码。以 Python 为例，你需要安装 Python 扩展，并在

.vscode/launch.json

登录后复制

文件中配置调试器。

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Remote Attach",
            "type": "python",
            "request": "attach",
            "connect": {
                "host": "localhost",
                "port": 5678 // 调试端口
            },
            "pathMappings": [
                {
                    "localRoot": "${workspaceFolder}",
                    "remoteRoot": "/app" // 容器中的代码路径
                }
            ]
        }
    ]
}

登录后复制

然后，在你的 Python 代码中添加如下代码：

import debugpy
debugpy.listen(("0.0.0.0", 5678))
debugpy.wait_for_client()  # 阻塞程序，直到调试器连接

登录后复制

运行你的 Python 代码，然后在 VSCode 中启动调试器。VSCode 会自动连接到容器中的调试器，你就可以像调试本地代码一样调试容器中的代码了。需要注意的是，容器中的调试端口需要通过

forwardPorts

登录后复制

转发到本地。

如何解决 VSCode Remote-Containers 连接慢的问题？

连接慢通常是因为需要下载 Docker 镜像，或者网络不稳定。

优化 Dockerfile： 尽量使用多阶段构建，减少镜像大小。
使用国内镜像源： 配置 Docker 使用国内镜像源，加快镜像下载速度。
检查网络连接： 确保你的网络连接稳定。
缓存机制： Docker 有缓存机制，如果你的
```
Dockerfile
```
登录后复制
没有修改，Docker 会直接使用缓存，加快构建速度。
预构建镜像： 可以提前构建好镜像，然后直接使用
```
Remote-Containers: Attach to Running Container...
```
登录后复制
连接到容器。

如何在 VSCode 中管理 Docker 容器？

VSCode 的 Docker 插件提供了强大的容器管理功能。

查看容器状态： 在 VSCode 的 Docker 视图中，你可以看到所有容器的状态，包括运行状态、端口映射、日志等。
启动/停止/重启容器： 你可以直接在 VSCode 中启动、停止、重启容器。
进入容器终端： 你可以直接在 VSCode 中进入容器的终端，执行命令。
查看容器日志： 你可以直接在 VSCode 中查看容器的日志，方便调试。
镜像管理： 你可以直接在 VSCode 中构建、推送、拉取 Docker 镜像。

如何避免 VSCode Remote-Containers 权限问题？

权限问题通常是因为容器内部的用户权限和宿主机的用户权限不一致。

使用
remoteUser
登录后复制
配置：在
```
devcontainer.json
```
登录后复制
中配置
```
remoteUser
```
登录后复制
，指定连接到容器的用户。
修改容器内部用户权限： 在
```
Dockerfile
```
登录后复制
中修改容器内部用户的权限，使其与宿主机用户权限一致。
使用 Docker Volumes： 使用 Docker Volumes 将宿主机目录挂载到容器内部，可以避免权限问题。
注意文件所有者： 确保容器内部的用户对需要操作的文件具有读写权限。