如何实现脚本一键启动VSCode并关联Docker容器打开工作区？

DevOps 小满

2026-5-14

一键简化VSCode + Docker容器开发流程的脚本方案

完全懂你的痛点——每次重复那一串启动、关联、切换窗口的步骤真的挺折腾人！我们可以写个简单的bash脚本，直接实现./launchVSCode <containerId> <workspaceFile>的一键操作，把所有繁琐步骤都打包进去。

脚本实现

创建一个名为launchVSCode的文件，粘贴以下内容：

#!/bin/bash

# 检查参数是否齐全
if [ $# -ne 2 ]; then
    echo "用法: $0 <containerId> <workspaceFile>"
    echo "示例: $0 my-dev-container /workspaces/my-project.code-workspace"
    exit 1
fi

CONTAINER_ID=$1
WORKSPACE_FILE=$2

# 检查VSCode命令是否可用（需提前将VSCode加入系统PATH）
if ! command -v code &> /dev/null; then
    echo "错误: 找不到VSCode的code命令，请确认VSCode已配置到系统PATH中"
    exit 1
fi

# 核心操作：直接启动VSCode并关联指定容器，打开目标工作区
echo "正在启动VSCode并关联容器 $CONTAINER_ID..."
code --remote=docker-container:$CONTAINER_ID "$WORKSPACE_FILE"

脚本说明

参数校验：确保用户传入了容器ID和工作区文件路径，避免因参数缺失导致的错误
环境检查：验证VSCode的code命令是否能正常调用（Windows用户可能需要手动配置系统PATH）
核心逻辑：利用VSCode Remote扩展的命令行能力，--remote=docker-container:<容器ID>会直接启动关联该容器的VSCode实例，同时指定工作区文件会自动在新实例中打开，彻底跳过手动关联、切换窗口的步骤

使用步骤

给脚本添加执行权限：
```
chmod +x launchVSCode
```
确保目标Docker容器已经处于运行状态（脚本不会自动启动容器，需提前启动好）
运行脚本：
```
./launchVSCode your-container-id /path/to/your/workspace.code-workspace
```
注意：这里的workspaceFile是容器内部的路径，不是本地路径，要确认工作区文件已在容器的挂载目录中