Tab 补全与 Cmd+K 内联编辑

Tab 补全：不只是自动完成

传统 IDE 的代码补全（如 IntelliSense）依靠 静态分析：解析 AST、查询符号表、匹配前缀，给出类型正确的候选项。 Cursor 的 Tab 补全在此基础上引入了 大语言模型的语义理解，能够做到：

• 根据注释或函数名 意图，生成完整的函数体实现
• 读懂你的代码风格，生成风格一致的代码
• 感知正在编写的 任务（如"正在填写测试用例"），连续补全多个类似测试
• 在你删除或修改一处代码后，预测相关位置的同步修改（Next Edit Suggestion）

补全的触发机制与上下文

Cursor Tab 在以下情况下会自动触发：

• 停顿触发（Idle Trigger） 光标静止约 300-500ms 后，自动请求补全建议并以幽灵文字显示。可在设置中调整延迟。
• 换行触发（Newline Trigger） 按 Enter 进入新行时，如果上下文强烈暗示接下来的代码，会立即显示建议。
• 注释触发（Comment Trigger） 输入 // 或 # 后写完注释，按 Enter，Cursor 会根据注释描述生成对应实现。这是最强大的触发模式。

上下文窗口（Context Window）

Tab 补全使用的上下文包含：

1. 当前文件：光标前后的完整代码（最高权重）
2. 相关文件：编辑器中已打开的 Tab 页、最近访问的文件
3. 同类文件：项目中语义相似的其他文件（通过向量索引找到）
4. 语言服务器信息：当前作用域的类型定义、符号信息

幽灵文字（Ghost Text）

幽灵文字（Ghost Text）是指补全建议以淡灰色"幽灵"形式显示在光标右侧或下方，还未被真正插入代码中。这种设计来自 GitHub Copilot，Cursor 沿用并增强了它。

幽灵文字的交互方式：

多行预测与代码块接受

Cursor 最区别于普通补全工具的特性是 多行代码块预测。它不仅补全当前行，还能一次性预测 5-30 行的完整代码块。

典型多行补全场景

// 场景一：根据注释生成完整函数
// 使用 fetch 调用 GitHub API 获取用户仓库列表，返回仓库名数组
async function getUserRepos(username: string): Promise<string[]> {
  // ← 光标在这里按 Tab，Cursor 会生成以下内容：
  const response = await fetch(
    `https://api.github.com/users/${username}/repos`,
    { headers: { 'Accept': 'application/vnd.github.v3+json' } }
  );
  if (!response.ok) throw new Error(`HTTP error: ${response.status}`);
  const repos: any[] = await response.json();
  return repos.map(r => r.name);
}

// 场景二：Next Edit Suggestion — 修改一处后预测相关修改
// 你将函数名从 getUserData 改为 fetchUserProfile
// Cursor 自动提示同文件中所有调用处也需要同步修改

const result1 = await fetchUserProfile(id1);  // Cursor 自动补全
const result2 = await fetchUserProfile(id2);  // 按 Tab 接受

Next Edit Suggestion（NES）

Next Edit Suggestion 是 Cursor 1.x 引入的智能功能：当你编辑一处代码时，Cursor 会分析其他需要同步修改的地方，并用特殊标记（→）提示你跳转过去接受建议。 使用 Tab 接受、Esc 忽略。这对于接口重命名、类型修改等牵一发而动全身的操作极其高效。

Cmd+K 内联编辑

Cmd+K（Mac）/ Ctrl+K（Windows）是 Cursor 的 内联编辑（Inline Edit）入口，它在光标位置或选中区域上方弹出一个紧凑的指令输入框， 让你用自然语言描述对代码的修改要求，AI 直接在编辑器中原地修改，以 diff 形式预览变更。

三种使用模式

• 无选中（Generate 模式） 光标放在空白位置，按 Cmd+K，输入描述，AI 在光标处生成新代码块。适合快速生成函数、类、配置文件等。
• 选中代码（Edit 模式） 先选中一段代码，再按 Cmd+K，AI 会根据指令重写选中部分。支持"优化性能"、"添加错误处理"、"转换为 async/await"等任意指令。
• 终端内 Cmd+K 在集成终端中按 Cmd+K，可以用自然语言描述想执行的命令，AI 生成对应的 shell 命令，按 Enter 执行。极大降低记忆复杂命令的负担。

Cmd+K 实战示例

// 选中以下函数后按 Cmd+K，输入"添加 TypeScript 类型注解和 JSDoc 注释"
function parseDate(str) {
  const parts = str.split('-');
  return new Date(parts[0], parts[1] - 1, parts[2]);
}

// AI 生成的结果：
/**
 * 将 YYYY-MM-DD 格式的日期字符串解析为 Date 对象
 * @param str - 日期字符串，格式：YYYY-MM-DD
 * @returns 对应的 Date 对象
 * @throws {Error} 当格式不合法时
 */
function parseDate(str: string): Date {
  const match = str.match(/^(\d{4})-(\d{2})-(\d{2})$/);
  if (!match) throw new Error(`Invalid date format: ${str}`);
  const [, year, month, day] = match.map(Number);
  return new Date(year, month - 1, day);
}

终端 Cmd+K 示例

# 在终端按 Cmd+K，输入：
# "找出当前目录下超过 30 天未修改的日志文件并删除"
# Cursor 生成：
find . -name "*.log" -mtime +30 -type f -delete

# 再如，输入"显示当前 Git 仓库中每位作者的提交次数"
git shortlog -sn --all

差异预览与 Apply 流程

Cmd+K 执行完成后，Cursor 以 内联 diff（Inline Diff）形式展示变更：

• 绿色高亮：新增的行
• 红色删除线：被删除的行
• 未改变的行保持原样

你可以：

完整快捷键速查

实战技巧与最佳实践

技巧一：用注释驱动生成

Cursor Tab 对注释的响应非常灵敏。养成习惯：先写注释，再按 Tab。注释越具体，生成质量越高。

// ❌ 太模糊的注释，生成质量差
// 处理用户数据

// ✅ 具体的注释，生成质量高
// 验证用户注册表单：email 格式、密码至少8位且含数字和字母、
// 用户名3-20位字母数字，返回 { valid: boolean, errors: string[] }

技巧二：利用已有代码做示范

当你文件里已经有类似函数时，Cursor 会学习其风格。写新函数之前，确保"示范函数"在文件上方可见， Cursor 会自动沿用相同的变量命名、错误处理风格、注释格式。

技巧三：Cmd+K 的指令要动词开头

❌ "这段代码有点慢"
✅ "优化此函数的性能，使用 Map 替代嵌套 for 循环"

❌ "更好的错误处理"
✅ "添加 try/catch 错误处理，捕获网络错误和 JSON 解析错误，抛出自定义 ApiError"

技巧四：Tab 补全 + 手动修改协同

不需要等待完美的一次性生成。接受 Tab 建议后，手动修改一两处细节，Cursor 会立即学习你的修改意图并调整后续建议。 这种"接受→微调→接受"的节奏往往比反复重新生成更高效。

技巧五：临时禁用 Tab 补全

在编写文档、注释或手动输入特定内容时，Tab 补全可能产生干扰。 状态栏右下角点击 Cursor 图标可快速切换开关，或用 Cmd+Shift+P → "Cursor: Toggle Tab Autocomplete"。