第四章：@ 符号 —— 给 AI 提供上下文的关键
← 上一章 | 返回目录 | 下一章 →
4.1 为什么上下文很重要？
想象一下这个场景：
你对一个陌生人说：“帮我把第三行改一下。”
陌生人：“什么第三行？哪个文件？改成什么？”
AI 也是一样。如果你不告诉 AI 你在说哪个文件、哪段代码，它只能靠猜。提供准确的上下文，是用好 AI 的关键技能。
在 Cursor 的 Chat 中，@ 符号就是给 AI 提供上下文的方式。
4.2 常用 @ 引用方式
在 Chat 输入框中输入 @，会弹出一个菜单，列出所有可用的引用类型。
@ 文件：引用具体文件
@main.py 帮我解释这个文件的代码这样 AI 就能”看到” main.py 的全部内容，给出准确的回答。
什么时候用？
- 讨论某个具体文件的代码
- 让 AI 修改某个文件
- 让 AI 基于某个文件创建类似的文件
@ 文件夹：引用整个文件夹
@src/ 分析一下这个项目的整体结构AI 会看到整个文件夹的结构和内容。
什么时候用？
- 让 AI 了解项目全貌
- 让 AI 在理解项目结构的基础上做修改
@Web：联网搜索
@Web Python 3.12 有什么新特性AI 会联网搜索最新信息后回答。
什么时候用？
- 查询最新的技术信息
- AI 的训练数据没有覆盖的新内容
- 想获取实时信息
@Docs：引用官方文档
@Docs 如何使用 pandas 的 read_csv 函数AI 会参考官方文档给出准确答案。
什么时候用？
- 学习某个库/框架的用法
- 需要准确的 API 参数说明
- 担心 AI “编造”不存在的 API
@Git：引用 Git 变更
@Git 这次我改了哪些文件？帮我写一个提交信息什么时候用？
- 查看代码变更
- 让 AI 帮你写 Git 提交信息
- 代码审查
4.3 实战练习
练习 1：引用文件让 AI 找 Bug
- 创建一个
buggy.py文件，故意写一些有 bug 的代码：
def divide(a, b):
return a / b
result = divide(10, 0)
print(result)
names = ["Alice", "Bob", "Charlie"]
print(names[5])- 在 Chat 中输入：
@buggy.py 帮我找出这个文件中所有的 bug 并修复- 观察 AI 如何识别和修复问题。
练习 2：引用文件夹分析项目
- 打开一个包含多个文件的项目文件夹
- 在 Chat 中输入：
@项目文件夹名/ 分析这个项目的结构，告诉我每个文件的作用练习 3：使用 @Web 获取信息
在 Chat 中输入：
@Web 2025年最流行的 Python Web 框架有哪些？各有什么优缺点？← 上一章：AI 功能详解 | 返回目录 | 下一章：实战演练 →