07-Cursor 独有技巧

Cursor 相比其他 AI 编辑器有许多独特功能，掌握这些技巧能大幅提升开发效率。

---

一、Cursor Tab 智能补全

1.1 Tab 补全基础

Cursor Tab 是最强大的功能之一，能预测整行甚至多行代码。

使用方法:

1. 正常编写代码
2. 当看到灰色提示文本时
3. 按 Tab 接受建议
4. 或继续输入忽略建议

1.2 Tab 补全示例

单行补全:

# 输入
def calculate_

# Cursor 提示 (灰色)
def calculate_average(numbers):

# 按 Tab 接受

多行补全:

# 输入函数名和注释
def process_csv_data(file_path):
    """读取 CSV 文件并返回处理后的数据"""

# Cursor 自动提示完整实现
def process_csv_data(file_path):
    """读取 CSV 文件并返回处理后的数据"""
    import pandas as pd
    df = pd.read_csv(file_path)
    # 数据清洗逻辑...
    return df

1.3 提升 Tab 补全质量

技巧	效果
写好函数名	准确的函数名让 AI 更好理解意图
添加文档字符串	说明函数目的，AI 生成更准确
定义类型注解	明确参数和返回类型
保持上下文	确保相关代码在同一文件

---

二、@符号快捷引用

2.1 文件引用

@文件名        → 引用单个文件
@文件夹/       → 引用整个目录
@文件名#行号   → 引用特定行

示例:

"请分析 @src/main.py 的入口逻辑"
"帮我把 @utils/ 目录下的所有函数添加类型注解"
"修复 @app.py#45-60 这段代码的错误"

2.2 符号引用

@类名          → 引用类定义
@函数名        → 引用函数定义
@变量名        → 引用变量

示例:

"为 @UserService 类添加日志功能"
"优化 @calculate_price 函数的性能"

2.3 文档引用

@docs python/pandas    → 查询 pandas 文档
@docs python/fastapi   → 查询 FastAPI 文档

---

三、快捷键大全

3.1 核心快捷键

功能	Windows/Linux	macOS
打开 Chat	Ctrl+L	Cmd+L
打开 Composer	Ctrl+I	Cmd+I
Inline Edit	Ctrl+K	Cmd+K
添加到 Chat	Ctrl+Shift+L	Cmd+Shift+L
接受 Tab 建议	Tab	Tab
拒绝 Tab 建议	Esc	Esc
切换 AI 面板	Ctrl+J	Cmd+J

3.2 编辑快捷键

功能	快捷键
生成文档字符串	Ctrl+Shift+D
代码格式化	Shift+Alt+F
快速修复	Ctrl+.
重命名符号	F2

3.3 导航快捷键

功能	快捷键
跳转到定义	F12
返回	Alt+←
前进	Alt+→
查找引用	Shift+F12

---

四、代码库索引与语义搜索

4.1 代码库索引

Cursor 会自动索引项目代码，实现语义级搜索。

功能:

• 理解代码语义，不只是文本匹配
• 支持自然语言搜索
• 跨文件理解代码关系

4.2 语义搜索使用

在 Chat 中输入：
"项目中哪个函数负责用户认证？"
"查找处理订单支付的代码"
"搜索所有使用 JWT 的地方"

4.3 索引管理

设置位置（根据 Cursor 版本可能略有不同）：

方式1：直接搜索（推荐）

1. 打开 Cursor Settings（Ctrl+, 或 Cmd+,）
2. 在顶部搜索框输入 "indexing" 或 "codebase"
3. 找到 "Codebase Indexing" 或 "Indexing" 相关设置

方式2：逐级菜单

Cursor → Settings → Cursor Settings → Features → Codebase Indexing
或
Cursor → Settings → General → Codebase Indexing
或
Cursor → Settings → Editor → Codebase Indexing

常见选项：

• 自动索引（推荐）：打开项目时自动建立索引
• 手动触发索引：需要时点击 “Index Now”
• 排除特定目录：如 node_modules/、__pycache__/ 等无需索引的目录

如果找不到：

• 确认 Cursor 已更新到最新版本
• 在 Settings 搜索栏直接输入 “index” 查找
• 该功能可能在某些 Cursor 版本中默认开启且无需配置

---

五、代码审查功能

5.1 请求代码审查（Cursor 2.6.22+）

方式1：选中代码后使用 Chat（推荐）

1. 选中要审查的代码
2. 按 Ctrl+L 打开 Chat 面板
3. 输入："请审查这段代码" 或 "分析这段代码的问题"
4. AI 会自动引用选中的代码进行审查

方式2：使用 @ 符号引用代码

1. 按 Ctrl+L 打开 Chat
2. 输入："审查 @文件名#行号范围 这段代码"
3. 示例："审查 @app.py#45-60 这段代码的安全性"

方式3：在 Agent 模式中审查

1. 按 Ctrl+I 打开 AI 面板
2. 选择 Agent 模式
3. 输入："审查当前文件的代码质量，包括：
   - 代码规范和命名
   - 潜在 Bug 和异常处理
   - 性能问题
   - 安全漏洞"

方式4：右键菜单（如有）

选中代码 → 右键 → 查看是否有 "Ask AI" / "Explain" / "Fix" 等相关选项
（不同版本右键菜单可能不同，以实际显示为准）

5.2 审查维度

维度	检查内容
代码规范	命名、格式、文档
潜在 Bug	空值、异常、边界
性能问题	复杂度、资源使用
安全漏洞	SQL 注入、XSS 等
可维护性	复杂度、耦合度

5.3 审查示例

# 被审查的代码
user_input = request.args.get('name')
query = f"SELECT * FROM users WHERE name = '{user_input}'"

AI 审查结果：
⚠️ 安全风险：存在 SQL 注入漏洞
建议：使用参数化查询

修正代码：
query = "SELECT * FROM users WHERE name = %s"
cursor.execute(query, (user_input,))

---

六、Bug 自动检测

6.1 实时错误检测

# 当代码有错误时
result = undefined_variable / 0
#         ^^^^^^^^^^^^^^^^
#         红色波浪线提示

6.2 一键修复

1. 将鼠标悬停在错误处
2. 点击 "Fix with AI"
3. AI 分析并提供修复方案
4. 一键应用修复

6.3 常见 Bug 检测

Bug 类型	检测示例
未定义变量	name 未定义
类型错误	len(123)
语法错误	缺少冒号
导入错误	模块不存在
逻辑错误	死循环风险

---

七、终端集成

7.1 打开终端

快捷键：Ctrl+`（反引号）
或菜单：View → Terminal

7.2 AI 辅助终端

在终端中输入自然语言命令：
$ 查找所有大于 1MB 的日志文件

Cursor 自动转换为：
$ find . -name "*.log" -size +1M

7.3 终端命令解释

选中终端中的命令 → 右键 → Explain Command
或 Chat 中输入："解释这条命令"

---

八、导入 VSCode 配置

8.1 一键导入（Cursor 2.6.22+）

首次启动：

安装后首次打开 Cursor 时选择：
"Import from VSCode"

之后通过设置：

方式1 - 搜索（推荐）：

1. Ctrl+, 打开 Settings
2. 搜索 "import from vscode"
3. 找到 "VS Code: Import" 设置

方式2 - 菜单：

Cursor → Settings → General → VS Code: Import
或
Cursor → Settings → Cursor Settings → General → VS Code: Import

8.2 可导入的内容

内容	说明
设置	settings.json
快捷键	keybindings.json
插件	兼容的 VSCode 插件
主题	颜色主题
代码片段	snippets

8.3 插件兼容性

大部分 VSCode 插件可直接使用
推荐安装：
- Python
- Pylance
- GitLens
- Error Lens

---

九、隐私与安全设置

9.1 隐私设置（Cursor 2.6.22+）

当前版本实际可用方式：

1. Ctrl+, 打开 Settings
2. 搜索以下关键词之一：
   - "privacy"
   - "telemetry"
   - "crash reporter"
   - "data"
3. 查找相关隐私相关设置

可能的相关设置项：

设置项	说明
telemetry	遥测数据收集
crash reporter	崩溃报告发送
Cursor: Privacy Mode	隐私模式（如果存在）

说明：Cursor 2.6.22 版本可能对隐私设置进行了调整，如果找不到 “Privacy Mode” 选项，可以通过上述关键词搜索查找隐私相关的设置项。也可能隐私模式已作为默认行为或整合到其他设置中。

9.2 API Key 管理（Cursor 2.6.22+）

推荐 - 搜索方式：

1. Ctrl+, 打开 Settings
2. 搜索 "api key"
3. 找到 "Cursor: API Key" 或 "Models: API Key" 设置

菜单方式：

Settings → Cursor → API Keys
或
Settings → Models → API Keys
或
Settings → Cursor Settings → Models → API Keys

配置选项：

• 使用 Cursor 官方服务（默认）
• 使用自己的 OpenAI API Key
• 使用其他兼容服务（如 OpenRouter、Z.AI）

9.3 本地模式与离线设置（Cursor 2.6.22+）

支持本地运行的功能：

• Tab 补全（本地模型）
• 基础代码分析（LSP）
• 离线缓存的代码补全

当前版本实际可用方式：

1. Ctrl+, 打开 Settings
2. 搜索以下关键词之一：
   - "local"
   - "offline"
   - "tab" （找到 Tab 补全相关设置）
   - "copilot"
3. 查找本地/离线相关的功能开关

可能的相关设置项：

设置项	说明
Cursor: Tab Completion	Tab 补全功能
Cursor: Enable Local Mode	本地模式（如果存在）
Cursor: Copilot	Copilot 集成（离线时不可用）

说明：Cursor 2.6.22 版本的设置界面与文档编写的版本可能有较大差异，建议使用搜索方式查找相关功能。大部分 AI 功能需要联网，纯本地模式功能有限。

---

十、效率技巧总结

10.1 快速编码流程

1. 写函数名和文档字符串（AI 理解意图）
2. 按 Tab 接受 AI 生成的函数体
3. 用 Ctrl+K 微调具体实现
4. 用 Ctrl+L 解释复杂逻辑

10.2 批量修改流程

1. 选中要修改的多个文件
2. Ctrl+I 打开 Agent 面板
3. 描述修改需求
4. 一键应用所有修改

10.3 问题排查流程

1. 发现报错（红色波浪线）
2. 悬停查看详情
3. Fix with AI 一键修复
4. 如复杂问题，用 Chat 深入分析

---

十一、下一步学习

完成本指南后，进入实战阶段：

1. 08-实战：Python数据分析工具.md - 综合运用所有技巧

---