Cursor 学习笔记

HeartRot
0 阅读5分钟

Cursor 学习笔记

菜鸟教程综合整理 | 2026.05 |

一、安装与启动

下载地址

官网：www.cursor.com/downloads

系统要求：Windows 10+ / macOS 10.15+ / Ubuntu 18.04+

快速安装

macOS：

  1. 下载 .dmg 文件
  2. 双击打开，将图标拖入 Applications
  3. 启动台打开 Cursor

Linux (Debian/Ubuntu)：

sudo dpkg -i cursor_<version>_amd64.deb
sudo apt-get install -f

Linux (Fedora/RHEL)：

sudo rpm -ivh cursor_<version>_x86_64.rpm

二、首次配置

启动流程

  1. 选择语言（支持中文）
  2. 阅读并接受服务条款
  3. 选择主题（深色/浅色）
  4. 选择快捷键方案（VS Code 兼容方案最常用）
  5. 登录账号（推荐用 GitHub 授权登录）

设置入口

  • 快捷键：Ctrl/Cmd + Shift + J
  • 或点击右上角齿轮图标

导入 VS Code 配置

如果之前用 VS Code，可以一键迁移：

Settings > General > Account > Import

汉化

  1. 左侧边栏点击扩展图标
  2. 搜索 Chinese (Simplified)
  3. 安装后重启即可

三、项目操作

打开项目

欢迎界面三个入口：

  • Open project — 打开本地已有项目
  • Clone repo — 克隆 Git 仓库，输入地址一键拉取
  • Connect via SSH — 连接远程服务器（适合云服务器开发）

快捷操作

  • 在集成终端打开：右键项目目录 → 选择"在集成终端打开"
  • 新建文件：资源管理器 → 点击文件夹旁的图标
  • 新建目录：同上，找旁边的目录图标

四、核心快捷键（最重要！）

AI 交互

功能Windows/LinuxmacOS
打开 AI 对话（Chat）Ctrl + LCmd + L
行内编辑（inline edit）Ctrl + KCmd + K
代码库问答Ctrl + /Cmd + /
Composer（多文件编辑）Ctrl + Shift + LCmd + Shift + L
Tab（接受 AI 补全）TabTab

终端

功能Windows/LinuxmacOS
显示/隐藏终端Ctrl + `` Cmd + ``
新建终端Ctrl + Shift + `` Cmd + Shift + ``
切换终端Ctrl + PageUp/PageDownCmd + PageUp/PageDown
关闭终端Ctrl + Shift + WCmd + Shift + W
浏览历史命令Ctrl + ↑/↓Cmd + ↑/↓

基础编辑

功能快捷键
撤销Ctrl + Z
重做Ctrl + Shift + Z
查找Ctrl + F
替换Ctrl + H
打开命令面板Ctrl + Shift + P
放大字体Ctrl + =
缩小字体Ctrl + -
重置缩放Ctrl + 0

五、@ 符号 — 上下文引用

在任何 AI 对话框中输入 @ 触发上下文菜单，这是 Cursor 最强大的功能之一。

常用指令

指令作用
@Files引用整个文件
@Folders引用整个文件夹
@Code引用特定代码片段
@Codebase搜索代码库相关文件
@Git引用 Git 提交、差异
@Web搜索网络信息
@Docs引用预设文档（可自定义）
@Definitions引用当前代码中的定义
@Chat引用聊天记录

操作方式

  • ↑/↓ 选择，Enter 确认
  • Ctrl/Cmd + M 切换完整读取/摘要读取模式

实战例子

# 生成登录功能，结合现有模型和 JWT 文档
@Files src/models/user.js @Docs https://jwt.io/introduction
生成用户登录功能

# 解释报错，结合代码段和最近提交
@Code 12-25行 @Git HEAD~1
解释这个报错原因

# 跨文件重构
@Folders src/components @Codebase
将类组件改为函数式组件

进阶技巧

  • 组合引用：@Files src/utils/helper.js @Codebase 同时引用文件+代码库
  • 隐私控制：创建 .cursorignore 文件排除敏感文件
  • 自定义文档：Settings > Features > Docs 添加自定义文档链接

六、Chat 与 Composer

Chat — 快速问答

  • 用自然语言提问、调试、解释代码
  • 适合即时解决简单问题
  • 支持代码片段引用

Composer — 复杂代码生成

  • 根据需求描述生成完整代码/文件
  • 支持多文件同时编辑
  • 适合新功能开发、重构

使用建议

小问题 → Chat；大功能 → Composer Composer 生成初版 → Chat 优化

七、模型设置

切换模型

  1. Settings > Models
  2. 选择想要的模型（GPT-4、Claude 等）
  3. 点击 Verify 验证

添加自定义模型

  1. Settings > Models > Add Model
  2. 输入模型名（如 deepseek-v3）
  3. 填入 API Key 和请求地址
  4. Verify 通过后勾选启用

示例（DeepSeek）：

  • 模型名：deepseek-v3 或 deepseek-r1
  • 请求地址：https://api.deepseek.com/chat/completions
  • API Key：去 platform.deepseek.com/ 申请

订阅套餐

套餐价格AI 对话代码补全模型
Hobby免费有限2000次/月基础模型
Pro$20/月无限无限GPT-4、Claude 等
Business$40/月无限无限+ 团队管理、SSO

八、集成终端

打开终端

  • 菜单栏：终端 > 新建终端
  • 快捷键：Ctrl/Cmd + ``
  • 右键目录：在集成终端打开

实用技巧

终端输出交互：

  • 按住 Ctrl/Cmd 悬停文件名 → 点击直接打开
  • 超链接可直接点击跳转浏览器

历史命令：

  • Ctrl/Cmd + ↑/↓ 浏览历史
  • 圆形图标可重新运行命令

多终端：

  • 点击右上角下拉菜单切换 Shell（Bash/PowerShell/Zsh）
  • + 图标新建终端
  • 拖动标签可分离为独立窗口

常用命令示例

# 创建文件
echo "Hello, Cursor" > greetings.txt

# 列出文件
ls

# 搜索文件内容
grep -n "关键词" *.txt

# 搜索命令（PowerShell）
Get-Command | Out-File -FilePath .\Command.txt

九、Vibe Coding 实战流程

场景：快速构建新功能

Step 1：用 Composer 生成初版

  1. Ctrl/Cmd + Shift + L 打开 Composer
  2. 用自然语言描述需求
  3. AI 生成代码，不满意继续追加指令调整

Step 2：用 Chat 优化 4. Ctrl/Cmd + L 打开 Chat 5. 引用代码片段，让 AI 解释或改写

Step 3：接受并运行 6. Tab 接受补全建议 7. Ctrl/Cmd + `` 打开终端运行测试

场景：调试报错

  1. 复制报错信息
  2. Ctrl/Cmd + L 打开 Chat
  3. 粘贴报错 + @Code 引用相关代码
  4. AI 分析原因，给出修复建议

十、常见问题

Q: Cursor 和 VS Code 什么关系？ A: Cursor 是 VS Code 的分支，快捷键、插件、主题完全兼容，无需重新学习。

Q: 国内能用吗？ A: 官网直连可用，AI 功能需要网络畅通。

Q: 免费额度够用吗？ A: Hobby 套餐适合体验，日常使用建议 Pro 或自带 API Key。

Q: 如何关闭垂直活动栏？ A: Settings > 搜索 workbench.activityBar.orientation > 改为 vertical > 重启

Q: 模型 API Key 从哪来？ A: 各模型官方平台申请（OpenAI、Anthropic、DeepSeek 等），或通过第三方平台获取。

附：快捷键速查表

AI 交互
  Ctrl/Cmd + L        打开 AI 对话
  Ctrl/Cmd + K        行内编辑
  Ctrl/Cmd + /        代码库问答
  Ctrl/Cmd + Shift + L  打开 Composer
  Tab                 接受补全

终端
  Ctrl/Cmd + `        显示/隐藏终端
  Ctrl/Cmd + Shift + ` 新建终端
  Ctrl/Cmd + PageUp/PageDown  切换终端

编辑
  Ctrl/Cmd + Z        撤销
  Ctrl/Cmd + Shift + Z  重做
  Ctrl/Cmd + F        查找
  Ctrl/Cmd + H        替换
  Ctrl/Cmd + Shift + P  命令面板
  Ctrl/Cmd + =/-      放大/缩小字体

整理自菜鸟教程 www.runoob.com/cursor/

avatar
文章
阅读
粉丝