官网:https://www.cursor.com/cn
推荐学习网站:https://www.cursor.fan/zh/get-started/usage/
W3Cschool:https://www.w3cschool.cn/cursordocs/cursor-codebase-code-base-query.html
Cursor隐私模式:http://cursor.ac.cn/en/security
我使用Cursor有一段时间了,大概两个月。总结一些Cursor的使用方法,当然Cursor的运用远不止此。
关键字
Cursor、AI工具、续杯
写在前面
在开始使用Cursor之后,你将会使用一种全新的方式进行开发,这将是革命性的。编码能力涵盖了很多能力,狭义来说,分为三种能力:编写代码能力,调试代码能力以及阅读代码能力。
在互联网时代,编写代码能力占比重最大,比如如何多线实现xx功能,但是AI时代,调试代码能力和阅读代码的能力将会更加重要。尽可能锻炼自己阅读代码的能力。
白嫖与付费
付费有点贵,个人版20$/月。
白嫖:
方式一:切换邮箱
切换注册邮箱,嫌麻烦可以注册一个无限邮箱。(比如,2925邮箱)但是如果切换太多邮箱就会遇到报错:“Too many free trial accounts used on this machine.”(此机器上使用了太多免费试用账户)
方式二:cursor-free-vip
推荐一个开源的工具,https://github.com/yeongpin/cursor-free-vip ,用过都说好。
功能:
- 重置机器ID,然后可以继续使用方式一续杯(解决:Too many free trial accounts used on this machine)。
- 我执行绕过Token限制后,比如图片中的账号,即使高级使用量已经满了,还能继续使用chat功能,但是Tab没出来?
注意:
- 配置检查:如果在使用过程中出现xxx文件不存在的情况,就需要去检查配置。工具界面可以罗列用到的配置。(如果安装Cursor自定义了目录可能会报错)
- 修改配置,📝 Config | 文件配置 Win / Macos / Linux Path | 路徑 [Documents/.cursor-free-vip/config.ini],比如:cursor_path修改为为cursor实际安装位置,参考默认配置修改。
- 似乎有些小bug,我拉源码看了,没发现问题,直接执行脚本也能行。等作者修复吧。
推荐模型
- 编码:大家都说好的,claude-3.7-sonnet
- chat:随便吧,我喜欢用最新的deepseek
Chat 三种模式
-
Ask 模式(问答模式):直接问答,AI 生成建议或代码,但不自动执行操作。
-
Agent 模式(代理模式):AI 自主完成任务,如修改代码、调试、重构等,会直接操作文件。
- 我的简单理解就是 Agent 模式会自动修改代码。
-
Manual 模式(手动模式):AI 仅提供建议,完全依赖用户手动操作(如复制粘贴)。
对比总结
模式 | 自动化程度 | 用户控制度 | 典型场景 |
---|---|---|---|
Ask | 低 | 高 | 快速问答、获取代码片段 |
Agent | 高 | 中/低 | 自动化修复、重构、复杂任务 |
Manual | 无 | 最高 | 精细调整、避免自动操作风险 |
在实际使用过程中,通常会使用Ask和Agent模式,Manual模式几乎不会使用。
Agent 模式不支持自己定义的 Model,比如自己的 DeepSeek API。
基本使用(核心)
Cursor最基本的使用总结为三个快捷键:
-
tab:Tab自动补全,我认为这是Cursor的灵魂功能。Cursor会在代码的不同位置出现提示内容,比如代码补全,注释等,你只需要Tab,Tab,Tab…就能节省大量工作量。
- Cursor会推断用户行为,比如你把光标停在注释位置,Cursor就可能自动生成注释。比如你有一段相似的代码,你修改了其中一处,Cursor就会提示你其它地方的修改。
- 这个功能和你的网速有关,如果你的网好,使用起来会畅享丝滑。
-
ctrl + l:聊天快捷键。类似于DeepSeek或ChatGPT两天页面,不过优势在于能跟轻松添加上下文。(@功能 或者 选中需要添加的上下文,选择Add To Chat)
-
ctrl + k:编辑快捷键。可以在你期望修改的位置,选中,ctrl + k,在弹窗中说出你的想要的修改。比如,添加注释,格式化,修改需求等等。同时也可以添加上下文。(@功能 或者 选中需要添加的上下文,选择Add To Edit)
初步使用就到此为止,其它功能用到再慢慢了解。以下是我找的资料,使用中一边实践一边理解吧。
小技巧:经常用到的关键词可以记录下来,很多时候关键词都是重复的哦。
引用上下文(核心)
@Files(引用文件)
@Docs(引用文档)
比如,添加 https://docs.cursor.com/ 这样就会索引该文档以及子目录子文档。(https://docs.cursor.com 只会索引该文档)
临时链接 @url
比如接口文档,需求文档,帮助文档等
@Web(联网搜索)
联网搜索实时信息
@git(Git 集成)
慎用吧,弄错了,影响到别人就麻烦了,自己的个人项目随便用。
功能:直接与 Git 版本控制系统集成,支持代码版本管理。
用途:
- 查看当前文件的 Git 变更记录(
@git history
)。 - 生成提交消息(
@git commit
自动建议描述)。 - 定位代码中的冲突或修改(
@git diff
)。
示例:
# 在 Cursor 中输入:
@git status # 查看当前仓库状态
@git blame example.py # 查看文件修改记录
@Past chats(历史对话)
功能:保存与 AI 的对话历史,支持回溯和复用。
用途:
- 快速查找过去的代码建议或解决方案。
- 复用上下文(如调试记录、重构思路)。
场景:
输入 @Past chats 优化算法
,可快速跳转到之前关于算法优化的讨论。
@Cursor rules(自定义规则)
功能:设置 AI 的行为约束(如代码风格、安全规则)。
用途:
- 强制 AI 生成符合团队规范的代码(如命名规则、缩进)。
- 限制敏感操作(如禁止修改 env 文件)。
示例:
# 规则示例:要求所有 Python 代码必须用类型注解
@Cursor rules enforce_type_hints = True
@Terminals(内置终端)
功能:在编辑器内直接运行命令行终端。
用途:
- 执行脚本、安装依赖、运行测试,无需切换窗口。
- 与 AI 生成的代码无缝衔接(如直接运行 AI 建议的命令)。
示例:
# 在 Cursor 终端中:
@Terminals run pytest tests/ # 运行测试
@CodeBase(代码库索引)
功能:索引整个项目代码,提供全局上下文理解。
用途:
- AI 基于完整项目结构生成代码(如跨文件调用函数)。
- 快速定位代码引用(如
@CodeBase find UserService
)。
场景:
输入 @CodeBase 如何实现用户登录?
,AI 会分析项目中的认证模块。
@Linter errors(代码检查)
功能:集成静态代码分析(如 ESLint、Pylint),实时提示错误。
用途:
- 自动修复语法错误或风格问题。
- 结合 AI 解释错误原因并提供修复建议。
示例:
// AI 提示:
@Linter errors: Missing semicolon (ESLint)
// 建议修复:在代码行末添加 `;`
忽略文件
要忽略在 Cursor 功能(如代码库索引)中包含的文件,您 可以在项目根目录中使用 .cursorignore 文件。它的工作方式与 .gitignore 对 git 的工作方式相同。
.cursorignore 遵循 .gitignore。如果您已经有 .gitignore,这些文件默认会被忽略。 如果您想忽略其他文件,可以将它们添加到 .cursorignore 文件中。
@Recent changes(近期变更)
功能:追踪最近编辑的文件或代码块。
用途:
- 快速撤销或对比修改(如
@Recent changes diff
)。 - AI 基于近期变更提供上下文建议。
场景:
输入 @Recent changes 为什么报错?
,AI 会分析刚修改的代码块。
数据安全
仔细阅读文档:https://cursor.ac.cn/en/security
隐私与数据安全
确保打开隐私模式:
- Cursor Settings > General > Privacy Mode 下启用 Privacy Mode。
- 启用后,代码数据不会以明文形式存储在Cursor的服务器或Cursor的子处理器处。
- 启用隐私模式后,代码数据不会持久化在Cursor的服务器或任何子处理器处。
- 用户的隐私模式设置存储在客户端上。每个发送到Cursor服务器的请求都包含一个 ‘x-ghost-mode’ 标头。
账户删除:
- 可以随时在 设置仪表板中删除您的账户(点击“高级”,然后点击“删除账户”)。这将删除与您的账户关联的所有数据,包括任何索引的代码库。Cursor保证在 30 天内完全删除您的数据(Cursor会立即删除数据,但Cursor的一些数据库和云存储的备份不超过 30 天)。