Cursor Pro for Mac 深度使用指南

Cursor Pro 是一款专为 macOS 设计的高级代码编辑器与集成开发环境（IDE），以其极致的性能、流畅的 AI 辅助编程体验和深度优化的原生 macOS 交互而著称。它不仅仅是一个文本编辑器，更是一个集成了智能代码补全、对话式编程、项目感知和高效工作流管理的现代化开发工具。本文旨在提供一份从入门到精通的详细操作手册。

一、核心界面与工作区详解

启动 Cursor Pro 后，您将看到一个设计简洁但功能强大的界面，主要分为以下几个区域：

• 活动栏（Activity Bar）：位于窗口最左侧的垂直图标栏。从上至下依次为：
  • 资源管理器（Explorer）：查看和管理项目文件与文件夹。
  • 搜索（Search）：全局搜索和替换。
  • 源代码管理（Source Control）：集成 Git 功能。
  • 运行与调试（Run and Debug）：配置和启动调试会话。
  • 扩展（Extensions）：管理插件。
  • Cursor Chat：打开 AI 对话侧边栏，进行代码问答和生成。
• 侧边栏（Sidebar）：点击活动栏图标后展开的区域，用于显示对应功能（如文件树、搜索框、Git变更等）的详细内容。
• 编辑器组（Editor Group）：窗口中央的核心区域，用于显示和编辑文件。支持水平或垂直分割成多个编辑窗格，实现多文件并排编辑。
• 面板（Panel）：窗口底部的区域，可以显示终端（Terminal）、问题（Problems）、输出（Output）、调试控制台（Debug Console）等。可通过快捷键 ⌘+J 快速显示或隐藏。
• 状态栏（Status Bar）：窗口最底部，显示当前项目信息（如 Git 分支、错误/警告数量）、光标位置、编码格式、缩进设置等，并包含一些快速操作按钮。
• 命令面板（Command Palette）：按下 ⇧+⌘+P 后出现在屏幕中央的浮动输入框。这是 Cursor Pro 的“总控中心”，几乎所有功能都可以通过在此输入命令来快速调用。

二、完整工作流程：从项目到导出

1. 创建或打开项目

步骤一：启动与初始选择

• 启动 Cursor Pro，欢迎页面会提供几个选项：新建文件（New File）、打开文件夹（Open Folder）、克隆仓库（Clone Repository）。
• 创建新项目：点击“新建文件”创建一个临时文件，或直接点击“打开文件夹”，然后在新弹出的 Finder 窗口中选择一个现有文件夹作为项目根目录，或创建一个新文件夹并打开。
• 打开现有项目：点击“打开文件夹”，导航至您的项目目录，点击“打开”。您也可以将文件夹直接拖拽到 Cursor Pro 的 Dock 图标或窗口内。
• 快捷键：打开项目文件夹的快捷键是 ⌘+O。

2. 文件与代码编辑

步骤二：创建与编辑文件

• 在资源管理器侧边栏中，将鼠标悬停在项目文件夹或子文件夹上，会出现“新建文件”和“新建文件夹”图标。点击即可创建。
• 更快捷的方式：在资源管理器空白处或文件夹上右键单击，选择“新建文件”。
• 快捷键：新建文件 ⌘+N，保存文件 ⌘+S，另存为 ⇧+⌘+S。

步骤三：基础编辑操作

• 光标移动：行首 ⌘+←，行尾 ⌘+→，文件开头 ⌘+↑，文件结尾 ⌘+↓。
• 文本选择：在以上光标移动快捷键中加入 ⇧ 键（如 ⇧+⌘+→ 选择至行尾）。
• 行操作：复制当前行 ⇧+⌘+C，移动行上下 ⌥+↑/↓，删除行 ⇧+⌘+K。
• 注释：切换行注释 ⌘+/，切换块注释 ⇧+⌥+A。

3. 使用 AI 辅助编程 (Cursor Chat)

步骤四：调用 AI 功能

• 点击活动栏的 Cursor Chat 图标（对话气泡），或按快捷键 ⌘+K，在编辑器中直接唤出 AI 指令输入框。
• 在 Chat 侧边栏中，您可以：
  • 用自然语言描述需求（如“为这个函数添加错误处理”）。
  • 选中一段代码后，在右键菜单中选择“Chat with Cursor”进行针对性提问。
  • 使用 ⌘+L 选中当前行，然后按 ⌘+K 快速就选中代码提问。
• AI 生成的代码片段可以直接插入到编辑器中的光标位置。

4. 构建、运行与调试

步骤五：配置与执行

• 切换到活动栏的 运行与调试 视图。
• 点击“创建 launch.json 文件”，Cursor Pro 会根据项目类型（如 Node.js, Python）提供配置模板。
• 在配置下拉菜单中选择您创建的配置，点击绿色的开始按钮或按 F5 启动调试。
• 调试时，顶部会出现调试工具栏（继续、单步跳过、单步进入等），编辑器会显示变量状态，底部面板显示调试控制台。
• 对于简单脚本，直接使用内置终端（Ctrl+` 打开）运行命令（如 python script.py）更为快捷。

5. 版本控制

步骤六：使用 Git

• 切换到活动栏的 源代码管理 视图。所有变更的文件会在此列出。
• 将鼠标悬停在文件上，点击“+”号或输入更改信息后点击“√”提交。
• 点击“…”更多操作菜单，可以进行推送（Push）、拉取（Pull）、分支管理等操作。
• 行内差异会直观地显示在编辑器的装订线（行号旁）中。

6. 导出与交付

步骤七：最终输出

• Cursor Pro 本身不直接“导出”项目，项目输出物取决于您的编程语言和构建工具。
• 通常的流程是：在终端中执行构建命令（如 npm run build），生成编译后的文件（如 dist/ 目录）。
• 您可以使用“文件”菜单中的“将工作区另存为…”来保存当前窗口布局和打开的文件状态。
• 确保所有代码已通过源代码管理提交并推送到远程仓库，完成交付。

三、常用功能进阶技巧

• 多光标编辑：按住 ⌥ 键并在不同位置点击，可以添加多个光标。按 ⌥+⌘+↑/↓ 可以在当前列位置向上/下添加光标。输入或删除会同时作用于所有光标。
• 快速重构：选中一个变量、函数名或代码块，右键选择“重命名符号”（F2），可以安全地重命名所有引用。
• 智能跳转：按住 ⌘键同时点击函数名或变量（鼠标变为手形），可以跳转到其定义处。使用 Ctrl+- 返回，⇧+Ctrl+- 前进。
• 代码片段（Snippets）：输入预设前缀（如 `for`， `func`）并按 Tab 键，会自动展开为预定义的代码模板，且可以通过 Tab 在占位符间跳转。
• 命令行的光标（Cursor in Terminal）：在集成终端中，您可以直接使用 ⌘+K 对终端中的命令输出或错误信息进行 AI 提问，实现无缝调试。

四、常见问题与解决方案

五、快捷键汇总表