文章目录
搞懂这三样，大仓库不卡、团队不慌、多任务不打架。
开场：为什么要在意「索引」？
Cursor 的语义搜索（@codebase、代码库问答）能让你用自然语言在项目里「捞」代码，准确率能提升一大截。但前提是：它得先把你整个代码库「消化」一遍------也就是建索引。
小项目几百个文件，秒好；大仓库几万个文件，要是每次都从零开建，等索引的那几十分钟够你泡杯茶、刷两集剧。所以 Cursor 给了三种玩法：Local、Cloud、Worktree。名字听起来像三种服务器，其实是三个不同维度的概念，用对了能省不少时间和脾气。
一、Local：自家厨房自家灶
Local = 索引只在你本机建、只给你用，不跟别人共享。
- 你第一次在 Cursor 里打开某个项目，它就在你电脑上吭哧吭哧扫文件、算 Merkle 树、生成嵌入向量。
- 之后你改代码、切分支，它只更新变动的部分，没动的就缓存着，所以日常会越来越快。
- 索引和数据都留在你机器上，适合注重隐私、离线、或者代码跟同事差很多的情况。
一句话：你的项目，你的索引，你的电脑说了算。
适合谁：个人项目、小仓库、不想依赖团队/云端、或者「我的代码就是独一无二」的选手。
二、Cloud：站在巨人的索引上
Cloud 指的是：复用团队或自己之前在云端存好的索引，不用每次都从零建。
现实很骨感：同一个公司里，大家 clone 的往往是同一套代码，相似度动不动就 90% 以上。所以 Cursor 会算一个「相似度指纹」（simhash），在团队里找一份最像的已有索引，复制一份给你用。
- 新同事、新电脑打开大仓库，不用再等几十分钟，几秒到几十秒就能开始语义搜索。
- 复制在后台进行，你可以立刻查代码；和你本地不一致的部分会慢慢同步，不会泄露你本地没有的文件。
- 通过 Merkle 树和内容证明，保证你搜到的一定是你本机已有的文件，不会看到别人机器上独有的东西。
一句话：前人栽树，后人乘凉；大仓库首次打开从「等一小时」变成「等一杯咖啡」。
适合谁：大仓库、团队协作、多人维护同一代码库、经常换电脑或新成员入职------省时间、省算力、还不牺牲安全。
三、Worktree：一人多角，各干各的
Worktree 来自 Git 的「工作树」：同一套仓库，可以拆成多个工作目录，各自对应不同分支，互不干扰。
在 Cursor 里，这招用来搞 Parallel Agents（并行 Agent）：
- 一个工作树写新功能（比如
feature/payment），另一个修 bug（fix/login），两个 Agent 各改各的目录，不会互相覆盖、不会乱切分支。 - 每个工作树可以有自己的索引（或参与云端复用），看你怎么配置；本质是「多个工作区」，而不是「另一种索引存储方式」。
一句话：同一个 repo，多开几个「平行世界」，多线程搬砖，线程之间还隔离得明明白白。
适合谁：同时推进多个需求/分支、多 Agent 并行干活、或者就是喜欢多窗口同时开同一仓库的狠人。
用一个小团队串起来
假设你们有一个大仓库 company-app，五万文件那种。
| 时间 | 人物 | 发生了什么 | 对应模式 |
|---|---|---|---|
| 周一 | 小明 | 第一次用 Cursor 打开 company-app，本机吭哧建索引，等了 40 分钟 |
Local |
| 周二 | 小红 | 打开同一仓库，Cursor 发现团队里已有索引，直接复用，20 秒就能搜 | Cloud |
| 周三 | 小刚 | 开两个 worktree，一个写 feature，一个修 bug，两个 Agent 并行干活 | Worktree |
| 周四 | 小明 | 换了台新电脑，再打开同一仓库，也走复用，几秒就绪，再也不用等 40 分钟 | Cloud |
所以：Local 是「从零建、自己用」；Cloud 是「站在已有索引上，大仓库秒开」；Worktree 是「多工作区并行」，和前面两个可以叠加使用。
对照表（方便扫一眼）
| 维度 | Local | Cloud | Worktree |
|---|---|---|---|
| 本质 | 索引只在本机建、本机用 | 索引在云端，可被团队复用 | 多个工作目录 / 并行任务 |
| 索引在哪 | 仅本机 | 本机 + 云端同步/复用 | 按工作区，可本地可参与云端 |
| 典型场景 | 个人、小项目、隐私、离线 | 大仓库、团队、快速上手 | 多分支、多 Agent 并行 |
小结
- Local：自家厨房自家灶，索引只在你电脑，适合个人或小项目。
- Cloud：站在巨人的索引上，大仓库秒开、团队共享，安全不泄密。
- Worktree：一人多角，多工作区并行，和 Local/Cloud 不冲突，可以一起用。
下次在设置里或文档里再看到这三个词，直接对号入座：要快 且大仓库/团队 就多想 Cloud，要多任务/多 Agent 就上 Worktree，要完全自管就认准 Local。三剑合璧，代码库再大也不慌。