前后端分仓时,用多根工作区在一个窗口里看两套 Git 提交
父目录不是 Git 仓库、下面各有独立前后端仓库时,用 Cursor 提示词生成 .code-workspace,在一个窗口里切换 SCM 看两套提交;进阶可配 Task/脚本对照 log。
你本地很可能就是这样一种目录: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 写文件。
步骤:
- File → Open Folder… 打开业务父目录
parent/(不要只开前端或后端子仓;否则 AI 不知道「旁边还有一仓」)。 - ⌘L 打开 Chat,或用 ⌘I(Composer / Agent)——需要直接在磁盘创建
*.code-workspace时,Agent 模式通常一次就能落盘。 - 粘贴下面提示词(改【】里的目录名与文件名),发送后按 AI 指引检查生成结果。
- 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
联调前可以快速自检:
- 创建
parent.code-workspace:用上文提示词让 Cursor 生成,或手写;folders里含 parent 根与两个子仓(路径与真实目录名一致)。 - 打开 File → Open Workspace from File,确认资源管理器显示多个根。
- 确认 SCM 能切换/看到两个仓库,各自改动不串仓。
- (可选) 添加
scripts/git-logs.sh与 Run Task,或用 Git Graph 图形化看历史。
若你已经在 Cursor 里深度使用 Git 与 AI 辅助提交,下一篇自然延伸阅读仍是 Cursor 快捷键与 Git/调试集成技巧——快捷键、合并冲突与 Chat 导出在那里展开;本篇只补「分仓时怎么把两个 Git 放进同一扇窗」这一块拼图。