> 技术文档 > VS Code远程Docker开发配置指南——完美速通_vscode docker

VS Code远程Docker开发配置指南——完美速通_vscode docker

首先,需要说明的是,本方案于2025年3月12日配置成功,若多年后vscode或若干插件改版,则可能部分步骤不支持哦

为了通过VS Code快速连接到远程服务器的Docker容器(假设名为my_fancy_docker),并实现本地修改代码、使用容器内Python环境的需求,请按照以下步骤操作:


通过 Remote-SSH + Remote-Containers 扩展

步骤 1:安装必要扩展
  1. 在本地VS Code中安装以下扩展:
    • Remote - SSH
    • Remote - Containers
步骤 2:配置 SSH 连接到远程服务器
  1. 打开VS Code的命令面板(Ctrl+Shift+P),输入 Remote-SSH: Connect to Host
  2. 选择 Configure SSH Hosts...,编辑SSH配置文件(如 ~/.ssh/config),添加服务器信息:
    Host remote-server HostName  User  IdentityFile ~/.ssh/私钥路径
  3. 保存后,选择 Remote-SSH: Connect to Host > remote-server,输入密码(如需要)连接到服务器。
步骤 3:附加到运行中的 Docker 容器
  1. 成功连接远程服务器后,在VS Code中打开命令面板(Ctrl+Shift+P)。
  2. 输入并选择 Remote-Containers: Attach to Running Container...
  3. 从列表中选择容器 my_fancy_docker,VS Code将重启窗口并进入容器内部。
步骤 4:配置开发环境
  1. 在容器内打开项目文件夹(如 /app)。
  2. 安装 Python 扩展(首次进入容器时,VS Code会提示安装推荐扩展)。
  3. 选择Python解释器:
    • 打开命令面板(Ctrl+Shift+P),输入 Python: Select Interpreter,选择容器内的Python路径(如 /usr/local/bin/python3)。