[Cursor-Guide]大型代码库管理
掌握在Cursor中管理大型代码库的专业技巧。学习如何高效自信地浏览、理解复杂项目并为其贡献代码。
[Cursor-Guide]大型代码库管理
原始链接: 原始链接
如何在Cursor中处理大型代码库
相较于小型项目，处理大型代码库会带来一系列新的挑战。基于我们扩展Cursor自身代码库的经验以及客户管理大型代码库的见解，我们总结出了一些应对复杂性的有效模式。
本指南将介绍我们在大型代码库管理中发现的实用技巧。
使用Chat功能快速熟悉陌生代码
浏览大型代码库（特别是新接触的代码库）可能颇具挑战性。通常需要通过grep、搜索和点击来寻找目标代码片段。借助Chat功能，您可以直接提问来定位目标代码并获取详细的工作原理说明。
以下示例展示了如何获取Cursor代码库索引的实现细节，并请求示例代码以便更好理解。
为增强Cursor对代码库结构的理解，请确保在设置中启用包含项目结构选项以获得更好的性能表现。
为领域特定知识编写规则
当有新成员加入代码库开发时，您会提供哪些背景信息来确保他们能做出有价值的贡献？
这些信息对Cursor同样重要。每个组织或项目都存在可能未完全记录在文档中的潜在知识。有效使用规则是确保Cursor全面理解项目的最佳方式。
例如，在编写新功能或服务的实现说明时，可以考虑添加简短规则以供后续参考。
模板示例
---
description: 添加新的VSCode前端服务
---
1. **接口定义:**
- 使用`createDecorator`定义新服务接口，确保包含`_serviceBrand`以避免错误
2. **服务实现:**
- 在新TypeScript文件中实现服务，继承`Disposable`，并使用`registerSingleton`注册为单例
3. **服务注册:**
- 创建贡献文件导入并加载服务，在主入口点进行注册
4. **上下文集成:**
- 更新上下文以包含新服务，确保全应用可访问
如需确保Cursor遵循特定代码格式规范，可考虑基于glob模式自动附加规则。
格式规范
---
globs: *.ts
---
- 使用bun作为包管理器，脚本参考[package.json](mdc:backend/reddit-eval-tool/package.json)
- 文件名采用kebab-case
- 函数和变量名采用camelCase
- 硬编码常量使用UPPERCASE_SNAKE_CASE
- 优先使用`function foo()`而非`const foo = () =>`
- 使用`Array<T>`而非`T[]`
- 使用命名导出而非默认导出（如`export const variable...`，`export function`）
重视计划制定过程
对于大型变更，投入更多精力制定精确、范围明确的计划能显著提升Cursor的输出质量。
如果多次调整提示词仍未获得理想结果，建议重新梳理需求并从头制定详细计划，就像为同事编写PRD（产品需求文档）一样。通常最困难的部分是确定需要做什么变更——这正是人类擅长的任务。通过正确指导，我们可以将部分实现工作委托给Cursor。
使用AI辅助计划制定的方法之一是启用提问模式。在Cursor中开启提问模式后，输入来自项目管理工具、内部文档或零散思路的所有上下文。考虑代码库中已知需要涉及的文件和依赖项，可以是需要集成的代码片段或整个文件夹。
示例提示词：
计划制定提示
- 制定创建新功能的计划（参照@existingfeature.ts实现）
- 如有不明确之处向我提问（最多3个问题）
- 确保搜索整个代码库
@历史对话（我之前探索的提示词）
来自[项目管理工具]的额外上下文：
[粘贴的需求描述]
我们要求模型通过向人类提问来制定计划并收集上下文，参考早期探索提示和需求描述。推荐使用claude-3.7-sonnet、gemini-2.5-pro或o3等思维模型，它们能更好理解变更意图并制定计划。
通过这种方式，您可以在开始实现前与Cursor协同迭代完善计划。
选择合适的工具
高效使用Cursor的关键技能之一是选择合适的工具。根据任务目标选择能保持流畅工作状态的方法。
各工具的最佳适用场景：
- Tab适合需要完全掌控的快速编辑
- Cmd K擅长对特定代码段进行聚焦修改
- Chat则适用于需要理解整体上下文的大型变更
使用Chat模式时（速度稍慢但功能强大），请通过提供优质上下文提升效率。使用@files指向参考代码，或使用@folder帮助理解项目结构。将大型变更拆分为小任务——开启新对话有助于保持专注和效率。