如何在VSCode多根工作区新终端自动运行tools仓库脚本？

核心思路 #

VSCode在启动终端时会自动注入VSCODE_WORKSPACE_FOLDERS环境变量，这个变量是JSON格式的数组，包含当前多根工作区所有顶级文件夹的名称和路径信息。我们可以通过解析这个变量找到tools仓库的位置，再在终端启动时自动切换目录并执行目标脚本，完全不需要依赖系统bash的全局配置。

方案1：基于Bash/Zsh的实现（Linux/macOS） #

1. 编写启动脚本
   创建一个终端启动脚本（比如start-tools.sh），内容如下：

#!/bin/bash
# 解析VSCode注入的工作区文件夹变量，定位tools仓库
TOOLS_DIR=$(echo "$VSCODE_WORKSPACE_FOLDERS" | jq -r '.[] | select(.name == "tools") | .path')

# 如果找到tools目录，切换过去并执行脚本
if [ -n "$TOOLS_DIR" ]; then
    cd "$TOOLS_DIR"
    # 替换成你要运行的脚本路径，比如./setup.sh
    ./setup.sh
fi

# 启动交互式shell，保证终端可用
exec "$SHELL"

如果你没有安装jq，可以用纯Bash解析（无需额外依赖）：

#!/bin/bash
TOOLS_DIR=""
IFS=$'\n'
# 遍历工作区文件夹路径，匹配名称为tools的目录
for folder in $(echo "$VSCODE_WORKSPACE_FOLDERS" | grep -o '"path":"[^"]*"'); do
    folder_path=$(echo "$folder" | cut -d'"' -f4)
    if [ "$(basename "$folder_path")" = "tools" ]; then
        TOOLS_DIR="$folder_path"
        break
    fi
done
unset IFS

if [ -n "$TOOLS_DIR" ]; then
    cd "$TOOLS_DIR"
    ./setup.sh
fi
exec "$SHELL"

2. 配置VSCode终端
   打开VSCode的settings.json，添加以下配置：

"terminal.integrated.profiles.linux": {
    "Tools Shell": {
        "path": "/bin/bash",
        "args": ["-c", "/absolute/path/to/start-tools.sh"]
    }
},
"terminal.integrated.defaultProfile.linux": "Tools Shell"

macOS用户把linux替换成osx即可。

方案2：基于PowerShell的实现（Windows） #

1. 编写启动脚本
   创建Start-Tools.ps1脚本，内容如下：

# 解析工作区文件夹变量
$workspaceFolders = $env:VSCODE_WORKSPACE_FOLDERS | ConvertFrom-Json
$toolsDir = ($workspaceFolders | Where-Object { $_.name -eq "tools" }).path

# 定位成功则切换目录并执行脚本
if ($toolsDir) {
    Set-Location $toolsDir
    # 替换成你的目标脚本
    .\setup.ps1
}

# 保持终端会话
powershell.exe -NoExit

2. 配置VSCode终端
   在settings.json中添加：

"terminal.integrated.profiles.windows": {
    "Tools PowerShell": {
        "source": "PowerShell",
        "args": ["-File", "C:\\absolute\\path\\to\\Start-Tools.ps1"]
    }
},
"terminal.integrated.defaultProfile.windows": "Tools PowerShell"

注意事项 #

• 确保脚本路径使用绝对路径，避免VSCode找不到脚本的问题
• 如果你的tools仓库在工作区中的名称不是tools，需要修改脚本中匹配的名称（比如select(.name == "your-tools-repo-name")）
• 测试时可以先手动运行脚本，确认能正确定位tools目录并执行目标脚本，再配置到VSCode中

内容的提问来源于stack exchange，提问作者Alpha Holborn