如何配置GitHub Codespaces启动时自动打开多终端执行预设命令

不需要依赖第三方VS Code扩展，直接使用Codespaces原生配置即可实现，全场景兼容Codespaces的web端、本地VS Code远程连接端。

推荐方案：devcontainer.json 绑定内置任务（稳定性最高） #

之前使用Terminal Manager扩展失效，核心原因是第三方扩展的终端调用API在Codespaces远程环境存在加载时序问题：扩展启动时Codespaces的终端服务还未完成初始化，即便读取到terminals.json配置也无法正常创建终端。原生配置不存在这个问题，配置步骤如下：

• 在仓库根目录创建.devcontainer文件夹，新建devcontainer.json配置文件
• 在配置中写入VS Code任务规则，每个任务对应一个独立终端，示例配置：

{
  "customizations": {
    "vscode": {
      "terminal.integrated.defaultProfile.linux": "bash",
      "tasks": {
        "version": "2.0.0",
        "tasks": [
          {
            "label": "启动前端服务",
            "type": "shell",
            "command": "npm start",
            "presentation": {
              "reveal": "always",
              "panel": "new",
              "focus": false
            },
            "runOptions": {
              "runOn": "folderOpen"
            }
          },
          {
            "label": "启动后端服务",
            "type": "shell",
            "command": "npm run server",
            "presentation": {
              "reveal": "always",
              "panel": "new",
              "focus": false
            },
            "runOptions": {
              "runOn": "folderOpen"
            }
          }
        ]
      }
    }
  }
}

• 配置参数说明：
  • panel: "new" 强制每个任务启动时创建新终端，不会复用已有终端窗口
  • runOn: "folderOpen" 配置任务在Codespaces加载完仓库目录后自动执行，不需要手动触发
  • 可按需增减任务条目，替换command字段内容即可修改每个终端要执行的预设命令
  • 如果需要某个终端启动后自动获得输入焦点，把对应任务的focus字段改为true即可

备选方案：tmux 配合启动钩子（适合需要终端状态保活的场景） #

如果需要断开Codespaces连接后终端运行的服务不中断、重连后直接恢复之前的终端状态，可以搭配tmux做初始化：

• 在devcontainer.json中添加容器创建后自动执行的钩子：

{
  "postCreateCommand": "bash ./.devcontainer/init-terminals.sh"
}

• 在.devcontainer目录下新建init-terminals.sh脚本，写入tmux会话初始化逻辑：

#!/bin/bash
# 新建名为dev的tmux会话，第一个窗口执行npm start
tmux new-session -d -s dev -n frontend 'npm start'
# 横向分屏，第二个窗口执行后端启动命令
tmux split-window -h -t dev:frontend 'npm run server'
# 纵向分屏，第三个窗口留作手动操作
tmux split-window -v -t dev:frontend
# 启动后自动附加到tmux会话
tmux attach-session -t dev

• 给脚本添加可执行权限，执行命令：chmod +x .devcontainer/init-terminals.sh

配置提交到仓库后，新建Codespace实例，等待环境初始化完成就会自动创建对应终端并执行预设命令，不需要额外手动操作。

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