Cursor完整操作手册：智能代码补全与重构

第一章：快速入门（注册登录、界面介绍、第一个任务）

第一章：快速入门

欢迎来到 Cursor 的世界！作为下一代 AI 驱动的代码编辑器，Cursor 旨在通过深度集成人工智能，极大提升开发者的编码效率与体验。本章将引导您从零开始，完成账号注册、熟悉核心界面，并执行您的第一个智能编程任务。请跟随以下步骤，轻松开启您的高效开发之旅。

1. 注册与登录

在使用 Cursor 之前，您需要拥有一个有效的账户。Cursor 支持多种主流认证方式，确保您能快速接入。

1. 下载与安装：访问 Cursor 官方网站，根据您的操作系统（Windows、macOS 或 Linux）下载对应的安装包。下载完成后，双击运行安装程序并按照提示完成安装。
2. 启动应用：打开 Cursor 编辑器。首次启动时，系统会显示欢迎界面。
3. 创建账户：
   • 点击屏幕中央的 “Sign Up”（注册）按钮。
   • 选择您偏好的登录方式，推荐使用 GitHub、Google 或 Email（邮箱）进行注册。
   • 若选择邮箱注册，请输入您的常用邮箱地址，设置密码，并点击 “Continue”。随后检查邮箱，点击验证链接以激活账户。
4. 登录账户：
   • 如果您已有账户，直接点击 “Log In”。
   • 输入您的账号凭证后，系统将自动跳转至主工作区。此时，您的头像将显示在界面右下角，表明登录成功。

注意：Cursor 提供免费套餐，但也提供 Pro 版本以获得更快的响应速度和更多的 API 调用次数。新用户注册通常会自动赠送一定的免费额度，足以满足日常学习和小规模项目需求。

2. 界面介绍

Cursor 的界面基于 VS Code 构建，因此对于熟悉 VS Code 的用户来说，上手毫无障碍。但对于新手，有几个核心区域需要特别关注：

• 活动栏（左侧）：这是导航中心。从左至右依次包括资源管理器、搜索、源代码管理、调试以及 Copilot Chat（AI 聊天面板）。点击最下方的机器人图标即可打开 AI 对话窗口，这是您与 AI 交互的主要入口。
• 命令面板（顶部中央或快捷键触发）：用于快速执行命令。您可以通过它查找文件、切换主题或运行特定的 AI 功能。
• 代码编辑区（中央）：您编写和查看代码的主要区域。在这里，您可以像往常一样编辑文本，但每一行都赋予了 AI 理解的能力。
• AI 聊天侧边栏（右侧）：当您在代码中选中文本并点击“Ask”或按下 Cmd+L / Ctrl+L 时，此区域会展开，允许您对当前文件进行上下文相关的提问或修改请求。

3. 第一个任务：让 AI 帮您写代码

现在，让我们通过一个简单的任务来体验 Cursor 的强大功能：创建一个简单的 Python 函数，用于计算斐波那契数列的第 n 项。

1. 新建文件：
   • 在资源管理器中右键点击空白处，选择 “New File”。
   • 将文件命名为 fibonacci.py，并按回车确认。
2. 使用 Composer 功能：
   • 在编辑器中，按下快捷键 Cmd+I（Mac）或 Ctrl+I（Windows/Linux）打开 Composer 窗口。这是一个多行输入的 AI 交互框，能够跨文件工作。
   • 在输入框中键入以下指令： > “请创建一个名为 get_fibonacci 的 Python 函数，接收一个整数 n，返回斐波那契数列的第 n 项。如果 n 小于等于 0，返回 0；如果 n 等于 1，返回 1。请在代码中添加详细的注释。”
   • 按下 Enter 键发送指令。
3. 预览与生成：
   • Cursor 的 AI 引擎会分析您的指令，并在 Composer 面板中生成一段预览代码。
   • 仔细检查生成的代码逻辑是否符合预期。如果有误，您可以在对话框中直接指出错误，例如：“请把递归改成迭代以提高效率。”
   • 确认无误后，点击预览区域右上角的 “Accept”（接受）按钮。
4. 结果验证：
   • 代码将自动插入到您的 fibonacci.py 文件中。
   • 您可以直接在编辑器下方打开终端，输入 python fibonacci.py 运行测试，或者在代码末尾添加几行测试用例并运行。

注意事项与最佳实践

• 保持上下文清晰：在与 AI 对话时，尽量提供具体的背景信息。例如，指明您使用的框架、库的版本或特定的业务逻辑，这样 AI 给出的建议会更精准。
• 逐步迭代：不要试图一次性让 AI 生成整个大型项目。建议将大任务拆解为小模块，逐个让 AI 实现并测试，这样更容易排查潜在问题。
• 安全审查：虽然 AI 非常强大，但它并非完美。对于涉及敏感数据、金融交易或关键安全逻辑的代码，务必进行人工审查，切勿完全依赖 AI 的输出。
• 利用快捷键：熟练掌握 Cmd+K（行内生成）、Cmd+L（聊天）和 Cmd+I（Composer）这三个核心快捷键，将显著提升您的工作效率。

通过以上步骤，您已经成功完成了在 Cursor 中的第一次 AI 辅助编码。接下来，您可以探索更多高级功能，如全局代码库索引、多文件重构等，进一步释放生产力。

第二章：基础功能详解（核心功能逐个讲解，带截图说明）

第二章：基础功能详解

欢迎来到 Cursor 的核心功能世界。本章将带你深入探索 Cursor 区别于传统编辑器的三大基石：Composer、Chat 和 智能补全。我们将通过具体的操作步骤，帮助你快速上手，提升开发效率。

2.1 Composer：多文件协同编辑引擎

Composer 是 Cursor 最具革命性的功能，它允许你通过自然语言描述需求，AI 会自动分析整个项目结构，并跨多个文件进行修改。这不仅仅是代码生成，更是架构层面的理解与执行。

操作步骤：

1. 启动 Composer：在编辑器界面中，按下 Command + I（Mac）或 Control + I（Windows/Linux），或者点击左侧活动栏中的“Composer”图标（通常显示为一个带有闪电符号的对话框）。
2. 输入指令：在弹出的 Composer 窗口中，清晰描述你的需求。例如：“请将当前项目的登录页面样式改为深色模式，并优化移动端布局。”
3. 预览与确认：AI 会生成一个修改计划，列出它将更改的文件列表及具体代码差异。注意观察右侧的文件对比视图，确保没有误改其他无关逻辑。
4. 应用更改：如果你觉得方案合理，点击右下角的“Apply”按钮。Cursor 将自动保存所有修改后的文件，并在底部终端中运行可能需要的命令（如安装依赖或重启服务）。

最佳实践与注意事项： * 上下文完整性：在输入指令前，建议先打开相关的关键文件，让 AI 明确当前的焦点。你也可以手动添加全局上下文，点击 Composer 窗口左上角的“+”号，选择“Add Context”，然后选择“Entire Project”，这样 AI 能理解全局依赖。 * 迭代式开发：不要试图一次性完成复杂的重构。将大任务拆解为小步骤，分次让 Composer 执行，每次只关注一个模块，这样能显著降低出错率。 * 警惕过度自信：虽然 Composer 很强大，但它可能会产生幻觉。务必人工审查生成的代码，特别是涉及业务逻辑和安全敏感的部分。

2.2 Chat：即时问答与代码解释

Chat 面板是你与 AI 对话的窗口，适用于解决具体问题、解释现有代码或寻求建议。它与普通的搜索引擎不同，因为它可以直接读取你当前打开的代码库上下文。

操作步骤：

1. 打开 Chat：按下 Command + L（Mac）或 Control + L（Windows/Linux），或者点击编辑器右上角的聊天气泡图标。
2. 引用代码：选中一段你想要询问的代码片段，然后点击 Chat 输入框上方的“引用”图标（通常是一个回形针或文档形状）。此时，选中的代码会被嵌入到对话上下文中。
3. 提问：输入你的问题，例如：“这段函数有什么潜在的性能瓶颈？”或“请用更简洁的方式重写这个循环。”
4. 获取答案与应用：AI 会在 Chat 窗口中给出解释。如果 AI 提供了新的代码块，你可以直接点击代码块右上角的“Apply”按钮，将修改直接插入到当前编辑器中，无需手动复制粘贴。

最佳实践与注意事项： * 提供背景信息：在提问时，尽量说明代码的作用和预期行为。例如，“我写了一个 API 接口，但返回了 500 错误，帮我排查原因。”比单纯说“修好这段代码”更有效。 * 利用 @ 符号：在 Chat 输入框中输入 @ 可以快速引用特定文件、文件夹或 Git 提交记录。例如，输入 @utils.js 可以让 AI 专门分析该工具函数。 * 区分学习与开发：Chat 更适合用于学习和调试，而复杂的结构性修改建议使用 Composer。

2.3 智能补全：流畅的编码体验

Cursor 的智能补全功能基于先进的模型，能够预测你接下来要写的代码，甚至整行整块的逻辑。

操作步骤：

1. 正常编码：像往常一样开始打字。
2. 触发补全：当你停顿片刻或输入部分关键字时，灰色的预填文本会出现。
3. 接受建议：按下 Tab 键接受整个补全内容。如果你只想接受部分，可以使用 Alt + ]（Mac）或 Alt + ]（Windows）逐词接受。
4. 拒绝建议：如果补全不正确，继续打字即可覆盖灰色文本，或者按下 Esc 键清除建议。

最佳实践与注意事项： * 保持代码风格一致：AI 会模仿你现有的代码风格。如果你希望 AI 遵循特定的命名规范或注释习惯，请在代码中保持前后一致，或在 Chat 中明确告知 AI 你的编码标准。 * 不要完全依赖：智能补全有时会生成看似正确但逻辑错误的代码。养成每写完一段重要逻辑后，立即运行测试或检查语法的习惯。

通过以上三个核心功能的组合使用，你将能够以极高的效率进行软件开发。记住，Cursor 是你的副驾驶，而非自动驾驶仪，始终掌握最终的控制权是关键。

第三章：高级技巧（提示词工程、多轮对话、风格控制）

第三章：高级技巧——解锁 Cursor 的潜在能力

在前两章中，我们熟悉了 Cursor 的基础界面与代码生成逻辑。本章将深入探讨如何像资深开发者一样思考，通过精细化的提示词工程、高效的多轮对话策略以及风格控制，将 AI 转化为真正懂你的结对编程伙伴。

3.1 提示词工程：从模糊到精准

提示词的质量直接决定了生成代码的可用性。避免使用“帮我写个登录页面”这种模糊指令，转而采用结构化、上下文丰富的表达方式。

操作步骤： 1. 选中代码区域：在编辑器中高亮你需要修改或解释的代码块。 2. 打开命令面板：按下 Cmd/Ctrl + K 组合键。 3. 输入结构化提示：在输入框中遵循“角色+背景+任务+约束”的公式。例如：“你是一名前端专家（角色）。当前组件使用了 React Hooks（背景）。请将此函数重构为异步处理，并添加错误边界（任务）。要求保持原有 CSS 样式不变，且注释需使用中文（约束）。” 4. 执行生成：按下回车键，观察生成的代码片段。

最佳实践： - 提供上下文：如果代码依赖外部库，请在提示词中明确提及库的名称和版本，甚至粘贴相关的 package.json 片段。 - 指定输出格式：明确要求 AI 返回代码块、仅解释还是包含测试用例，以减少后期整理时间。

3.2 多轮对话：迭代式优化代码

单次生成往往难以完美契合复杂需求，多轮对话允许你逐步细化意图，修正偏差。

操作步骤： 1. 发起首轮请求：在 Chat 窗口中输入初步需求，例如：“创建一个用户个人资料页。” 2. 审查初始结果：查看 AI 生成的代码结构，检查是否有遗漏的功能点或逻辑错误。 3. 进行第二轮迭代：基于上一轮结果提出具体修改意见。例如：“布局看起来不错，但请将头像上传功能改为拖拽方式，并添加文件大小校验提示。” 4. 持续反馈：若 AI 理解有误，直接指出错误原因而非重新描述需求。例如：“你误解了‘校验’的意思，我需要的是前端实时验证，而非后端提交时的验证。”

注意事项： - 保持语境连贯：Cursor 会记住之前的对话历史，因此无需重复背景信息，直接针对细节进行修改即可。 - 及时纠正：一旦发现 AI 走向错误方向，立即打断并纠正，避免累积错误的代码上下文。

3.3 风格控制：统一代码规范

为了保持项目代码的一致性，你可以强制 AI 遵循特定的编码风格和架构模式。

操作步骤： 1. 创建规则文件：在项目根目录新建 .cursorrules 文件（若不存在则创建）。 2. 编写风格指南：在文件中详细描述你的偏好。例如：“始终使用 TypeScript 严格模式”、“组件命名采用 PascalCase”、“禁止使用 console.log，改用 logger 模块”。 3. 激活规则：保存文件后，Cursor 会自动读取该配置。 4. 验证效果：重新请求生成一段代码，检查是否符合预设风格。若不合规，可在 Chat 中提醒：“请根据 .cursorrules 中的规范重新生成此部分代码。”

最佳实践： - 集中管理：将所有风格约束集中在 .cursorrules 中，便于团队共享和维护。 - 示例驱动：在规则文件中提供“正确 vs 错误”的代码示例，能显著提高 AI 对风格理解的准确度。

通过掌握这些高级技巧，你将不再被动接受 AI 的默认输出，而是主动引导其生成高质量、符合项目规范的代码。记住，Cursor 是强大的工具，而你是驾驭它的船长。

第四章：实战案例（3个真实场景完整演示）

第四章：实战案例——从零到一的完整演示

本章将通过三个贴近日常开发工作的高频场景，深入演示 Cursor 的核心功能。我们将重点展示如何利用自然语言驱动代码生成、重构以及调试，帮助新手快速建立对 AI 辅助编程的直观认知。

案例一：从零构建一个待办事项应用界面

假设你刚接手一个新项目，需要快速搭建一个简洁的前端页面。不要手动编写每一行 HTML 和 CSS，而是让 Cursor 成为你的灵感助手。

操作步骤：

1. 新建文件并创建上下文：在编辑器中右键点击项目文件夹，选择“新建文件”，命名为 index.html。此时，按下 Cmd+K（Mac）或 Ctrl+K（Windows）打开内联聊天框。
2. 输入提示词：在对话框中输入：“请为我创建一个现代化的待办事项应用界面。要求使用 Tailwind CSS，包含一个输入框、一个‘添加’按钮，以及一个显示任务列表的区域。样式要简洁美观。”
3. 审查与生成：Cursor 会自动分析当前项目结构，并生成完整的 HTML 代码块。点击代码块右上角的“插入”按钮，将代码直接写入文件。
4. 微调样式：如果生成的颜色不符合预期，选中生成的按钮部分，再次按下 Cmd+K，输入：“将按钮背景色改为深蓝色，悬停时变为浅蓝色。” 确认无误后，再次点击“插入”。

注意事项与最佳实践： * 保持上下文清晰：在提示词中明确指出使用的技术栈（如 Tailwind CSS），避免 AI 生成通用的 Bootstrap 代码导致冲突。 * 逐步迭代：不要试图一次性生成整个复杂应用。先完成核心布局，再逐步添加交互逻辑，这样更容易控制 AI 的输出质量。

案例二：智能重构与代码优化

当你面对一段混乱且难以维护的代码时，Cursor 能像资深工程师一样进行梳理。以下演示如何优化一个复杂的 JavaScript 数据处理函数。

操作步骤：

1. 定位问题代码：打开包含复杂逻辑的文件，找到那段嵌套过深、变量命名随意的函数。
2. 选中并请求重构：用鼠标选中整个函数体，按下 Cmd+L（Mac）或 Ctrl+L 打开侧边聊天窗口。在输入框中键入：“重构这段代码。请遵循 SOLID 原则，提取重复逻辑为独立函数，并将变量名改为语义化名称，同时添加必要的注释。”
3. 评估建议：Cursor 会提供重构后的代码版本。仔细检查其逻辑是否改变了原有业务行为。通常，AI 会建议将数据过滤、映射和归约分离开来。
4. 应用更改：确认逻辑正确后，点击“接受”按钮。此时，原本冗长的代码将变得清晰易读，且便于后续测试。

注意事项与最佳实践： * 验证安全性：AI 可能会引入新的依赖或改变副作用行为。在应用重构前，务必运行单元测试以确保功能一致性。 * 明确约束条件：在提示词中强调“不改变原有业务逻辑”，防止 AI 为了追求简洁而错误地简化了关键的业务规则。

案例三：快速定位并修复 Bug

当程序出现异常报错时，与其花费大量时间阅读日志，不如让 AI 直接分析错误原因。

操作步骤：

1. 复制错误信息：在终端或控制台复制最新的报错堆栈信息。
2. 粘贴至聊天窗口：在侧边栏聊天中输入：“我遇到了这个错误：[粘贴错误信息]。请分析可能的原因，并给出修复方案。”
3. 关联代码上下文：为了让回答更精准，你可以同时选中报错所在的代码文件中的相关片段，作为上下文一起发送给 AI。例如：“在 [文件名] 的第 20 行附近出现了空指针引用，请检查此处的逻辑。”
4. 获取修复代码：Cursor 通常会指出具体的问题行，并提供修改后的代码片段。点击“插入”应用修复，然后重新运行程序验证是否解决。

注意事项与最佳实践： * 提供完整上下文：单独的错误信息往往不足以定位深层问题。务必结合相关的代码片段和环境描述，以提高诊断准确率。 * 理解而非盲从：AI 给出的修复方案可能并非最优解。阅读其解释，理解错误根源，这有助于提升自身的调试能力，避免未来重蹈覆辙。

通过以上三个案例，我们可以看到 Cursor 不仅是一个代码生成器，更是贯穿开发全生命周期的智能伙伴。熟练掌握这些工作流，将极大提升你的开发效率与代码质量。

第五章：效率提升（快捷键、模板库、批量处理）

第五章：效率提升——快捷键、模板库与批量处理

在掌握了 Cursor 的基础代码编辑与 AI 对话功能后，如何进一步挖掘其潜力以实现“指数级”的效率飞跃，是区分普通用户与高效开发者的关键。本章将深入讲解如何利用快捷键、模板库以及批量处理功能，让你的编码流程如闪电般迅捷。

一、 极速导航：核心快捷键指南

熟练运用快捷键可以显著减少鼠标操作频率，保持心流状态。以下是 Cursor 中最高频且必须掌握的快捷键组合：

• Cmd/Ctrl + K：这是 Cursor 的灵魂快捷键。在编辑器任意位置按下此组合键，即可唤起 AI 聊天窗口。你可以直接在此输入指令修改当前选中的代码，或者让 AI 解释整段逻辑。
  • 操作步骤：选中一段代码 → 按下 Cmd/Ctrl + K → 输入“优化这段代码的性能” → 预览差异 → 点击“Apply”应用更改。
• Cmd/Ctrl + L：打开全局命令面板。当你忘记某个功能在哪，或想快速执行特定任务（如切换主题、打开设置）时，这是最快的入口。
  • 操作步骤：按下 Cmd/Ctrl + L → 输入关键词（如“theme”）→ 选择对应选项 → 立即生效。
• Cmd/Ctrl + J：启动智能补全建议。不同于传统的 Tab 补全，Cursor 会根据上下文预测你接下来要写的多行代码甚至整个函数。
  • 操作步骤：开始输入函数名 → 等待灰色预览文本出现 → 按下 Tab 键接受建议 → 代码自动展开。
• Cmd/Ctrl + Shift + P：打开命令调色板。用于执行高级操作，如格式化文档、切换分支或运行终端命令。

最佳实践：建议在初期刻意练习 Cmd/Ctrl + K 的使用场景，将其作为默认的 AI 交互方式，而非依赖右上角的图标。

二、 重复劳动终结者：模板库的使用技巧

对于常见的业务逻辑、组件结构或配置文件，重复编写不仅浪费时间，还容易出错。Cursor 内置了强大的模板库，支持自定义 Snippet。

• 创建自定义模板：
  • 操作步骤：点击左侧活动栏的“Cursor Settings” → 选择“Snippets” → 点击“New Snippet” → 输入名称（如“React-Component”）→ 在右侧编辑器中粘贴你的标准代码框架 → 保存。
  • 使用方式：在代码文件中输入你设定的名称（如“react”），按下 Enter，标准组件结构即刻生成。
• 利用社区模板：
  • Cursor 拥有活跃的社区，许多开发者分享了针对特定框架（如 Vue3、Next.js）的最佳实践模板。
  • 操作步骤：在设置中找到“Extensions”或访问 Cursor 官方社区 → 搜索“template” → 安装热门模板包 → 重启 IDE 后即可在命令面板中使用。

注意事项：自定义模板时，尽量使用占位符（如 ${1:variableName}），以便生成后光标能自动跳转到需要修改的关键位置，实现一键填充。

三、 批量处理：大规模重构与统一风格

当项目规模扩大，需要统一变量命名、修改接口格式或清理无用代码时，手动逐行修改是不现实的。Cursor 的批量处理能力能瞬间完成这些任务。

• 全局搜索与替换增强：
  • 操作步骤：按下 Cmd/Ctrl + Shift + F 打开全局搜索 → 输入目标字符串（如“oldFunctionName”）→ 在搜索结果面板中，点击“Replace All” → 确认无误后执行。
  • 进阶技巧：结合正则表达式进行复杂模式的批量替换。例如，将所有 console.log 语句注释掉或移除，只需在搜索框开启正则模式并输入匹配逻辑。
• AI 辅助的大文件重构：
  • 对于超过几千行的巨型文件，直接全选让 AI 重写可能导致上下文丢失。
  • 操作步骤：使用 Cmd/Ctrl + G 跳转到特定代码块 → 选中该模块 → 按下 Cmd/Ctrl + K → 输入“重构此模块，使其符合 SOLID 原则” → 逐步应用修改。这种方式比一次性处理整个文件更稳定、可控。
• 批量生成测试用例：
  • 操作步骤：选中核心业务逻辑代码 → 按下 Cmd/Ctrl + K → 输入“为这段代码生成 Jest 单元测试，覆盖正常路径和边界情况” → 点击“Insert at End of File” → 测试文件自动生成。

最佳实践：在执行任何批量操作前，务必先进行小范围的试点测试。特别是在使用 AI 进行全局重构时，建议先在副本分支上操作，确认无误后再合并到主分支，以防不可逆的代码损坏。

通过熟练掌握上述快捷键、灵活配置模板库并谨慎使用批量处理功能，你将能够把 Cursor 从一个简单的代码编辑器，升级为真正懂你的智能编程伙伴，大幅提升开发幸福感与产出效率。

第六章：常见问题与解决方案（FAQ，10个高频问题）

第六章：常见问题与解决方案

在使用 Cursor 进行开发的过程中，遇到报错或功能异常是常态。本章整理了十个最高频的问题及其解决方案，帮助您快速排除障碍，提升编码效率。

1. AI 生成的代码无法运行怎么办？

当 AI 输出的代码出现语法错误或逻辑漏洞时，请不要手动修改，而是利用对话上下文让 AI 自我修复。

• 操作步骤：选中报错的代码块 → 右键选择“Fix”或使用快捷键 Cmd+K → 在输入框中简要描述错误信息（如“这里报空指针异常”）→ 按下回车 → 观察 AI 自动替换后的代码。
• 最佳实践：尽量提供具体的错误日志，模糊的描述会导致 AI 猜测，降低修复准确率。

2. 如何引用项目中的其他文件？

Cursor 的强大之处在于能理解整个项目结构，但有时它可能忽略某些依赖。

• 操作步骤：在聊天窗口中输入 @ 符号 → 在弹出的菜单中选择“Files” → 搜索并勾选需要引用的源文件 → 发送指令（如“参考 @config.js 的配置方式重写 @app.py”）。
• 注意事项：避免引用过于庞大的二进制文件或构建产物，仅引用源代码文件以获得最佳效果。

3. 为什么 AI 回答很慢或卡住？

响应延迟通常由网络波动或模型负载引起。

• 操作步骤：检查网络连接是否正常 → 若持续卡顿，点击界面右上角的设置图标 → 进入“General”选项卡 → 尝试切换不同的 Provider（如从默认模型切换到更轻量的模型）→ 重启编辑器以刷新连接。
• 最佳实践：在代码库极大时，建议先清理未使用的依赖，减轻 AI 的索引负担。

4. 如何重置 AI 的上下文记忆？

如果之前的对话干扰了当前任务，清除上下文是关键。

• 操作步骤：打开 Chat 面板 → 点击右上角的“垃圾桶”图标或“Clear Context”按钮 → 确认清除 → 开始新的任务对话。
• 注意事项：此操作不可逆，请确保重要信息已保存或不再需要。

5. 如何为特定文件夹设置规则？

通过 .cursorrules 文件可以定制 AI 的行为风格。

• 操作步骤：在项目根目录创建 .cursorrules 文件 → 用文本编辑器打开 → 写入自然语言指令（如“始终使用 TypeScript 严格模式”、“禁止使用 console.log”）→ 保存文件 → AI 将自动遵循这些规则。
• 最佳实践：规则应简洁明确，避免使用歧义词汇，越具体的约束效果越好。

6. 代码补全功能不显示或无效？

智能补全依赖于本地索引和设置。

• 操作步骤：检查状态栏右下角的补全图标是否亮起 → 若熄灭，点击它开启 → 若仍无效，进入设置 → 搜索“Completion” → 确保“Enable Auto Completion”已勾选 → 尝试重新加载窗口。
• 注意事项：某些特殊语言插件可能与原生补全冲突，必要时可单独配置语言特定的补全策略。

7. 如何处理 Git 冲突？

AI 可以辅助解决复杂的合并冲突。

• 操作步骤：当 Git 提示冲突时 → 打开冲突文件 → 使用 Cmd+Shift+P → 输入“Resolve Conflicts with AI” → 选择“Accept All”或“Review Each” → 查看 AI 提供的合并方案 → 确认无误后提交。
• 最佳实践：对于核心业务逻辑，建议人工审查 AI 的合并结果，防止数据丢失。

8. 为什么 AI 不理解我的自定义框架？

如果使用的是非主流框架，AI 可能缺乏相关知识。

• 操作步骤：在 Chat 中输入 /doc → 上传相关的官方文档 PDF 或 Markdown 文件 → 在提问时引用这些文档（如“根据 @docs.md，如何实现...”）。
• 注意事项：定期更新文档索引，确保 AI 获取的是最新 API 信息。

9. 快捷键失效如何解决？

系统冲突或设置错误可能导致快捷键失灵。

• 操作步骤：进入设置 → 搜索“Keybindings” → 查找对应功能的快捷键 → 检查是否有重复定义 → 若无冲突，尝试重置为默认设置 → 重启编辑器测试。
• 最佳实践：自定义快捷键时，避免使用系统保留键（如 Ctrl+C/V），以防被操作系统拦截。

10. 如何备份和恢复对话历史？

意外关闭导致对话丢失令人沮丧。

• 操作步骤：点击 Chat 面板右上角的菜单按钮 → 选择“Export History” → 保存为 JSON 或 Markdown 文件 → 恢复时可通过“Import History”功能加载。
• 注意事项：频繁的重要对话建议定期导出备份，以防本地数据损坏。

通过以上步骤，您可以高效解决 Cursor 使用中的绝大多数技术问题，让 AI 真正成为您的得力编程助手。