在 Cursor 中引用特定函数进行重构，最精准的方式是使用 @Code 选中函数代码块，或使用 @Files 引用包含该函数的文件。若需分析函数定义关系，可配合 @Definitions 使用，确保 AI 仅基于目标逻辑生成变更。
先说结论：通过 @Code 选中函数体或 @Files 锁定文件路径，能明确界定 AI 的重构范围。
- 适合：需要修改具体函数逻辑、优化算法或修复局部 Bug 的场景
- 先看：确认编辑器中已选中目标代码或已知文件路径
- 建议：重构前提交 Git 快照，以便对比差异或快速回滚
命令速用版
在 Chat 输入框或 Cmd+K 面板中，直接输入以下格式触发上下文引用：
@Code 请将此函数改为异步处理
@Files src/utils/helper.ts 重构这个文件中的日期处理逻辑
@Definitions 查看当前函数的所有定义引用
为什么会这样
AI 模型需要明确的上下文边界才能避免幻觉或误改无关代码。
Cursor 的 @ 符号系统本质是一套智能上下文引用机制，通过不同前缀让 AI 理解你需要引用的内容类型。直接选中代码或使用 @Code 能节省上下文空间并精准聚焦，而 @Files 则提供完整的文件结构供 AI 理解依赖关系。
分步处理
- 选中目标代码：在编辑器中用鼠标或键盘选中需要重构的函数体。
- 注入上下文：在 Chat 框或
Cmd+K中输入@Code，系统会自动识别已选内容。 - 输入指令：追加自然语言指令，例如“将此 Promise 链改为 async/await 并添加错误重试逻辑”。
- 确认变更：检查 AI 生成的 Diff 预览，确认无误后应用修改。
若函数分散在多个文件，可按住 Ctrl 或 Cmd 依次选中不同文件中的相关代码段，再输入 @Code 聚合上下文。
怎么验证是否生效
应用修改后，通过以下方式确认重构结果：
- 代码差异：查看编辑器中的绿色高亮变更区域，确认逻辑是否符合预期。
- 运行测试：执行项目单元测试或手动触发相关功能，确保无回归错误。
- 类型检查：若是 TypeScript 项目，观察是否有新的类型报错提示。
常见坑
- 上下文丢失：若函数依赖外部变量未选中，AI 可能无法理解完整逻辑，建议配合
@Files引用完整文件。 - 命名冲突：重构后若函数签名变更，需检查所有调用处是否同步更新，可使用
@Codebase搜索引用位置。 - 忽略排除项：使用
@Folders时，注意.cursorignore规则可能会排除某些文件，导致上下文不全。
常见问题
可以直接输入函数名引用吗？
目前主要依靠 @Files 指定文件路径或 @Code 选中代码，直接输入函数名通常需配合文件路径使用。
重构后代码报错怎么办？
立即使用 Cmd+Z 撤销修改，或从 Git 记录中回滚，然后尝试提供更完整的上下文重新生成。
如何引用多个文件中的相关函数？
按住 Ctrl 或 Cmd 跨文件选中多个代码段，输入 @Code 即可将分散逻辑聚合给 AI 分析。
参考来源
- 详解 Cursor @符号用法：如何引用文件、文档和全库搜索
- Cursor 高级技巧:@符号、Chat 模式与多文件编辑
- 玩转 Cursor 的 @ 符号：精准上下文引用的实战指南
- Cursor AI 的 @ 符号有哪些高级用法？