Yutao Liu
← 文章
开发工具约 10 分钟

前后端分仓时,用多根工作区在一个窗口里看两套 Git 提交

父目录不是 Git 仓库、下面各有独立前后端仓库时,用 Cursor 提示词生成 .code-workspace,在一个窗口里切换 SCM 看两套提交;进阶可配 Task/脚本对照 log。

目录 多数人不知道的是什么 最小可行配置(手把手) 进阶:工作区里还能写什么 何时不必用工作区 收尾 checklist

你本地很可能就是这样一种目录:parent/ 只是业务项目的「壳子」,里面各放一套前后端仓库,例如 parent/frontend/、parent/backend/(名字也可能是 uassc-web、uassc-server 之类)。父目录本身往往不是 Git 仓库,两边各自 git init 或从远端 clone,版本互不挂靠。联调时你要同时改 API 契约和页面,却要在一堆窗口和终端里来回切——谁改了什么、提交先后关系,全靠印象和群里吼一声。

凑合做法大家都熟:前端开一个 Cursor/VS Code 窗口,后端再开一个;全局搜索要么做两遍,要么只在当前仓搜;看提交记录就 cd 到另一个目录再 git log。缺点很具体:上下文断裂(AI Chat、断点、未保存的 scratch 笔记都绑在单仓窗口上)、对照成本高(两边各一条功能提交,时间线要对齐时得开两个终端并排滚日志)、误操作风险(在错的窗口里 commit、或者把本应属于另一仓的文件拖进暂存区——单根打开时 SCM 只显示一个仓,有时反而会让人忘掉「旁边还有一仓」)。

下面这套做法不碰你的仓库结构,只是把本地编辑体验收成一根工作区,并在需要时一眼对照两套提交。

多数人不知道的是什么

VS Code / Cursor 的 Multi-root Workspace(多根工作区)靠一个 *.code-workspace JSON 文件声明:同一个编辑器窗口里挂载多个独立文件夹根。它只是把你机器上的目录「摆进同一个 UI」,不会把两个 Git 仓库 merge 成一个,也不会替你改 remote、分支策略或发布流程。

一句话:工作区是「怎么开编辑器」的配置,不是「怎么管代码」的架构决策。

和 monorepo、submodule 的边界可以这么记:

方式本质更适合什么时候
多根工作区本地窗口里并列多个已有仓库历史原因前后端分仓、临时联调、父目录只放文档/脚本
Monorepo一个 Git 仓里多包/多应用,统一版本与 CI团队已定统一发布节奏,需要原子化跨端提交
Git submodule / subtree主仓记录子仓 commit 指针强依赖固定上游版本、或要把第三方库钉死在主项目

若你团队已经 monorepo,或只看 GitLab/GitHub 网页上的提交图就够,本文后半的「何时不必用」会直接帮你省时间。若你仍是典型的 分仓 + 本地联调,多根工作区通常是成本最低的一层胶水。

最小可行配置(手把手)

假设目录类似:

parent/
├── frontend/     # 独立 Git 仓库(前端)
├── backend/      # 独立 Git 仓库(后端)
├── scripts/      # 可选:联调脚本、docker-compose 等(未必是 Git 仓)
└── README.md

子目录叫 uassc-web / uassc-server 也完全可以,不必为了写工作区而改名——下面提示词里换成你的真实文件夹名即可。

1. 用 Cursor 生成工作区(推荐,不必手写 JSON)

现实中多数人不会自己去记 folders 字段。更省事的做法:先让编辑器看见整个 parent,再让 AI 写文件。

步骤:

  1. File → Open Folder… 打开业务父目录 parent/(不要只开前端或后端子仓;否则 AI 不知道「旁边还有一仓」)。
  2. ⌘L 打开 Chat,或用 ⌘I(Composer / Agent)——需要直接在磁盘创建 *.code-workspace 时,Agent 模式通常一次就能落盘。
  3. 粘贴下面提示词(改【】里的目录名与文件名),发送后按 AI 指引检查生成结果。
  4. File → Open Workspace from File… 选中刚生成的 *.code-workspace。窗口会重载,左侧资源管理器应出现 三个根(parent + 前端 + 后端)。

可复制提示词(最小版):

当前打开的是前后端分仓的业务父目录,不是 monorepo。子目录里至少有两个独立 Git 仓库:
- 【前端目录名,如 frontend】/
- 【后端目录名,如 backend】/
父目录本身通常没有 .git;可有 scripts/、docker-compose、接口约定文档等。

请在本目录根下新建 VS Code/Cursor 多根工作区文件,文件名:【如 my-project.code-workspace】。

要求:
1. folders 三项:path "."(工作区根,name 简短即可)、上述前端目录、上述后端目录;path 全部用相对路径
2. 仅最小配置:folders + "settings": {};不要加 tasks、extensions、推荐插件
3. 写文件前若不确定子目录名,先根据当前工作区列出可见的一级目录,再写 JSON
4. 完成后告诉我:用 File → Open Workspace from File 打开;并说明 SCM 里应能看到几个 Git 仓库

不要修改任何仓库内的代码,只创建这一个 .code-workspace 文件。

生成后肉眼扫一眼:folders[].path 是否与你磁盘上的文件夹一字不差。然后按提示 Open Workspace from File;以后可从「最近打开」固定该工作区,不必每天纠结先开哪一仓。

可选:手写最小 JSON(对照 AI 输出)

想自己改、或离线不用 AI 时,核心结构如下(与上面提示词要求一致):

{
  "folders": [
    {
      "name": "工作区根",
      "path": "."
    },
    {
      "name": "Frontend",
      "path": "frontend"
    },
    {
      "name": "Backend",
      "path": "backend"
    }
  ],
  "settings": {}
}
  • path: "." 表示工作区文件所在父目录,便于编辑 scripts/ 等不属于任一子仓的文件。
  • name 只影响侧栏显示,不影响 Git;emoji 可让 AI 加,也可不加。

2. 打开工作区后应看到什么

菜单:File → Open Workspace from File…(也可 File → Open… 直接选 .code-workspace)。标题栏往往显示工作区文件名,而不是单独的 frontend。若仍只看到一个根,多半是当前还在「单文件夹模式」——确认打开的是 .code-workspace 而不是再次 Open Folder 到子仓。

3. 源代码管理(SCM)里会看到多个仓库

按 ⌘Shift+G(Windows/Linux:Ctrl+Shift+G)打开源代码管理面板。启用多根后,常见形态是:

  • 顶部有 仓库选择器(或分列显示各仓库名称),可在 Frontend、Backend 之间切换;
  • 每个根下的变更只出现在对应仓库里;在 frontend/src/... 改动的文件不会混进 backend 的暂存区。

查看历史 / 提交记录的方式(与单仓相同,只是要记得先选中对的仓库):

  • 时间线 / 文件历史:在某一仓的文件上右键,使用 Git 相关「Open Timeline」或扩展提供的 history(若已装 GitLens / Git Graph)。
  • 提交列表:命令面板(⌘Shift+P)搜索 Git: View History 或安装 Git Graph 后从该仓根上下文打开图形化 log。
  • 终端:在工作区里开集成终端时,注意 当前工作目录 落在哪个根;可对两个终端分别 cd 到 frontend、backend 各跑 git log --oneline -15。

多根工作区解决的是「两个 SCM 实体共存在一个窗口」;不会自动帮你做跨仓 cherry-pick 或约定式提交对齐——那仍是你团队流程里的事。

关于 Cursor 里 AI 生成提交信息、冲突处理等,可参考站内已有文章 Cursor 快捷键与 Git/调试集成技巧 第四节,本文不再重复快捷键矩阵。

进阶:工作区里还能写什么

settings(按需,各一句)

在工作区 JSON 里增加 settings 块,只写你真正需要的项,例如:

{
  "folders": [ /* 同上 */ ],
  "settings": {
    "git.autoRepositoryDetection": true,
    "scm.repositories.visible": 10
  }
}
  • git.autoRepositoryDetection:为 true 时,编辑器会在工作区文件夹内继续探测嵌套 .git(默认行为对多根通常够用;若你故意关掉过,多仓联调时建议打开)。
  • scm.repositories.visible:提高 SCM 面板同时展示的仓库数量上限,避免第三个、第四个仓(例如 shared-contracts)被折叠看不见。

还可按根配置语言格式化、eslint 工作目录等,但那是代码质量话题;多根联调的最小集通常只要上面两条 + 下面的 Task。

tasks:一键对照最近提交

在 parent/scripts/ 放一个小脚本,用颜色区分两仓最近 N 条提交,避免手打两次 git log:

scripts/git-logs.sh:

#!/usr/bin/env bash
# 在 parent/ 目录执行:对比 frontend / backend 最近提交
set -euo pipefail

ROOT="$(cd "$(dirname "$0")/.." && pwd)"
FRONT="${ROOT}/frontend"
BACK="${ROOT}/backend"
LINES="${1:-12}"

print_repo() {
  local label="$1"
  local dir="$2"
  if [[ ! -d "${dir}/.git" ]]; then
    echo "== ${label}: 未找到 Git 仓库 (${dir})"
    return
  fi
  echo ""
  echo "======== ${label} (${dir}) ========"
  git -C "${dir}" log --oneline --decorate -n "${LINES}"
}

print_repo "Frontend" "${FRONT}"
print_repo "Backend"  "${BACK}"
echo ""

赋予可执行权限:chmod +x scripts/git-logs.sh。在工作区文件里追加 tasks:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Git: 前后台最近提交",
      "type": "shell",
      "command": "${workspaceFolder:📁 工作区(parent)}/scripts/git-logs.sh",
      "options": {
        "cwd": "${workspaceFolder:📁 工作区(parent)}"
      },
      "group": "none",
      "presentation": {
        "reveal": "always",
        "panel": "dedicated",
        "clear": true
      }
    }
  ]
}

注意:${workspaceFolder:📁 工作区(parent)} 里的名称必须与工作区 folders[].name 完全一致(含 emoji)。运行:Terminal → Run Task… 选「Git: 前后台最近提交」,输出会在专用终端里并排两段 log,适合联调前「对表」。

extensions recommendations(可选)

在工作区 JSON 顶层增加:

"extensions": {
  "recommendations": [
    "mhutchie.git-graph",
    "eamodio.gitlens"
  ]
}

打开工作区时编辑器会提示安装。Git Graph 适合快速看分支图;GitLens 适合行内 blame 与 richer history。二者都不是必需,内置 Git + 上面的脚本已经能完成「看两套提交」的主线目标。

完整工作区示例(settings + tasks + extensions)

把前述片段合并后,结构类似:

{
  "folders": [
    { "name": "📁 工作区(parent)", "path": "." },
    { "name": "🌐 Frontend", "path": "frontend" },
    { "name": "⚙️ Backend", "path": "backend" }
  ],
  "settings": {
    "git.autoRepositoryDetection": true,
    "scm.repositories.visible": 10
  },
  "tasks": {
    "version": "2.0.0",
    "tasks": [
      {
        "label": "Git: 前后台最近提交",
        "type": "shell",
        "command": "${workspaceFolder:📁 工作区(parent)}/scripts/git-logs.sh",
        "presentation": { "reveal": "always", "panel": "dedicated", "clear": true }
      }
    ]
  },
  "extensions": {
    "recommendations": ["mhutchie.git-graph", "eamodio.gitlens"]
  }
}

把该文件提交进 Git 与否由你决定:若 parent/ 不是仓库,可以只放在本机或放进 wiki;若有一个「meta」仓只存运维脚本,工作区文件放在那里也很常见。不要把 Token、内网地址写进 JSON。

何时不必用工作区

诚实地说,多根工作区不是银弹:

  • 只有一个 Git 仓库(含 monorepo):直接 Open Folder 即可,多根反而多一层配置。
  • 团队已 monorepo + 统一 CI:跨端变更在一个 PR 里,提交时间线在远端一眼可读,本地不必为了「看两套 log」专门建工作区。
  • 你几乎不在本地看 Git,只看 GitLab/GitHub 或发行说明:保持双窗口或只用网页也够用。
  • 子模块工作流很重、且成员不熟悉多根 SCM 切换:培训成本可能高于收益;要么推进 monorepo,要么写清文档约定「联调日必须打开 xxx.code-workspace」。

若你介于「分仓」和「想 monorepo 但还没迁」之间,多根工作区通常是几分钟能搭好、随时可删的过渡方案。

收尾 checklist

联调前可以快速自检:

  1. 创建 parent.code-workspace:用上文提示词让 Cursor 生成,或手写;folders 里含 parent 根与两个子仓(路径与真实目录名一致)。
  2. 打开 File → Open Workspace from File,确认资源管理器显示多个根。
  3. 确认 SCM 能切换/看到两个仓库,各自改动不串仓。
  4. (可选) 添加 scripts/git-logs.sh 与 Run Task,或用 Git Graph 图形化看历史。

若你已经在 Cursor 里深度使用 Git 与 AI 辅助提交,下一篇自然延伸阅读仍是 Cursor 快捷键与 Git/调试集成技巧——快捷键、合并冲突与 Chat 导出在那里展开;本篇只补「分仓时怎么把两个 Git 放进同一扇窗」这一块拼图。