3.2.2 注释驱动代码生成

除了根据已有代码上下文自动续写，Cursor 的行内补全还支持"注释即指令"的生成方式：你在注释里用自然语言描述需求，换行后 AI 会自动将其转化为实现代码。

基本操作

在代码文件中输入一条描述性注释，按下回车换行并稍作停顿（通常 1–2 秒），Cursor 会以灰色虚影形式给出对应的代码实现。如果符合预期，按 Tab 键完整采纳；若只想接受前半部分，按 Ctrl/Cmd + → 逐词采纳，剩余不符合预期的内容可按 Esc 取消。

让注释更有效的写法

• 具体优于笼统：写 // 过滤出年龄大于18且状态为active的用户 比 // 处理用户数据 生成的代码准确得多。
• 带上类型或格式提示：在 Python 中注明 // 返回一个包含 name 和 email 的字典，在 TypeScript 中注明 // 返回 User[]，能显著减少类型错误。
• 分步拆解复杂逻辑：需求较复杂时，先写高层注释生成函数骨架，再在每个子步骤里写注释生成具体实现，避免一次生成过长而出错。

真实示例

# 写一个函数，接收文件路径，返回该文件的MD5哈希值，如果文件不存在返回None

换行后，Cursor 通常会直接补全为：

import hashlib
import os

def get_file_md5(file_path):
    if not os.path.exists(file_path):
        return None
    with open(file_path, 'rb') as f:
        return hashlib.md5(f.read()).hexdigest()

与多行注释的配合

对于复杂函数，你可以在函数体内部连续使用单行注释作为"步骤清单"。每写完一条注释并换行，AI 就会补全该步骤的实现，你只需逐行按 Tab，就能像搭积木一样完成整块逻辑。

注意事项

• 注释语言支持中英文，但建议与项目文档语言保持一致，减少歧义。
• 如果 AI 生成的首行不符合预期，不要连续按 Tab，先按 Esc 取消，修改注释措辞后再试。过于模糊的指令容易导致 AI"自由发挥"，偏离实际需求。