第1章 Cursor 安装与界面介绍（Copilot 安装与使用）

目标概述

本章目标是帮助你在本地电脑安装 Cursor AI 代码编辑器，完成初始配置，并了解其界面组成和基本功能，包括如何启用 GitHub Copilot 或 Cursor 自带的 AI 功能。学完本章，你将能够启动 Cursor，熟悉左侧文件管理、中央代码编辑区和右侧 AI 聊天面板等界面元素[1]，并能够使用 AI 自动补全和简易对话功能编写代码。

主要知识点

Cursor 简介：Cursor 是一款基于 VS Code 的 AI 驱动代码编辑器[2]，内置强大的 AI 自动补全、代码说明和错误检测等功能[3]。它可以使用内置模型（如 Claude）或 GitHub Copilot 提供 AI 编码建议。
安装 Cursor：支持 Windows、macOS 和 Linux，安装流程与 VS Code 类似[4]。需要注意操作系统要求（Windows 10+ / macOS 10.15+ / Ubuntu 18.04+ 等）和网络连接（AI 功能需联网）[5]。
首次启动配置：Cursor 首次打开会引导用户设置熟悉的快捷键方案、主题和终端偏好[6]。可选择导入 VS Code 设置，确保已安装所需语言运行环境（如 Python）[7]。建议创建免费账号登录以解锁全部 AI 特性[8]（Cursor 未登录下有限制）。
界面布局：Cursor 界面与 VS Code 类似，包含左侧文件资源管理器，中间代码编辑区，右侧AI 聊天/Composer 面板，底部状态栏[1]。编辑器支持多标签打开文件；右侧的 Chat 面板可通过快捷键打开（Windows: Ctrl+L / Mac: Cmd+L）用于和 AI 对话[9]。还有Inline Prompt/Composer功能，可选中代码按 Ctrl+K 呼出内联编辑提示框，对选中代码进行 AI 修改[10]。
Copilot 与 Cursor AI：安装 Cursor 后，首次启动的引导会询问使用 Cursor 自带AI还是 GitHub Copilot[11][12]。如果你拥有 Copilot 订阅并希望使用，可在向导中选择 GitHub Copilot 并登录 GitHub。但需注意 Cursor 与 Copilot 并非无缝集成，如果切换需重新运行引导，目前 Cursor 更推荐其内置模型[13]。初学者可先使用 Cursor 内置的免费AI（14天专业版试用）体验完整功能。

完整操作流程

下载 Cursor 安装包：访问 Cursor 官方网站[14]（https://cursor.com），根据操作系统下载相应安装程序。
运行安装程序：双击下载的安装文件，按提示完成安装。Windows 用户可右键选择“以管理员身份运行”，macOS 用户打开 .dmg 后将 Cursor 拖入 Applications 文件夹[15][16]，Linux 用户下载 .deb 或 .rpm 包并使用包管理器安装[17]。
首次启动：启动 Cursor 应用。首次运行会要求登录或注册 Cursor 帐号（使用邮箱注册即可，建议登录以利用AI功能）。随后进入初始设置向导：
选择快捷键方案（VS Code/Sublime/JetBrains 等）[18][19]
选择界面主题和字体（可跳过或稍后更改）
设置终端类型（例如默认Shell，通常保持默认）
是否安装命令行启动脚本（例如 cursor 命令，用于通过终端启动 Cursor 项目）[20]
（可选）导入 VS Code 配置：如本机装有 VS Code，可一键导入扩展、主题和快捷键[21][22]。
界面介绍：完成设置后，进入 Cursor 主界面：
文件资源管理器（左侧）：点击“Open Folder”打开一个项目文件夹（或通过菜单 File -> Open Folder）。可以创建新文件/文件夹。
代码编辑区（中央）：双击左侧文件打开编辑。在编辑区键入代码时，Cursor AI 会根据上下文给出灰色补全建议（类似智能提示），按下 Tab 键可接受建议[23]。
AI 聊天面板（右侧）：界面右侧有“Chat”或 Cursor 图标标签。点击或使用快捷键打开聊天栏。你可以在底部文本框向 AI 提问，如“这段代码有什么作用？”或“请帮我修复错误”。AI 的回答会显示在对话区，帮助理解或生成代码。
状态栏（底部）：显示 Git 分支、文件编码、换行符、光标位置等状态。右下角通常还有模型指示（如使用 Cursor 模型或 Copilot）。
[24]下面的截图展示了 Cursor 挂载静态文件目录的代码，表明 Cursor 可用于Web开发等场景。

Cursor 界面示例：左侧资源管理器，中央编辑器，右侧AI聊天栏（带进度指示）[1]

启用 AI 自动补全：默认情况下，Cursor 安装完成并登录后，其内置的 Tab 自动补全（代号“Tab”模型）自动启用，可直接在代码中使用[25]。如果选择了 Copilot，则需确保你已登录 GitHub 且 Copilot 开启，Cursor 会调用 Copilot 提供补全。注意：若 Cursor 未登录账号，将只能使用有限的本地补全，无法调用云端AI[8]。
简单试用：创建一个新文件 hello.py，输入：

print("Hello")

停在引号后面几秒钟，观察 Cursor 右侧弹出Tab 提示，可能会建议补全 print("Hello World") 等。按下 Tab 接受建议。然后输入新行 for i in range(5): 并按回车，看AI是否提示补全循环内部代码。尝试按 Ctrl+L 打开聊天，对 AI 输入：“请告诉我这段代码的作用”。体验 AI 即时解答。

操作截图或流程

上图展示了 Cursor 编辑器的基本界面布局及索引进度提示。[26]Cursor 打开项目后会自动索引代码库，如上图状态栏所示。当你打开一个大型项目时，Cursor 会扫描项目文件构建索引，以便提高 AI 建议的准确性[27]。索引进度可以在设置中的“Indexing & Docs”页面查看，索引完成后，AI 将能够更好地“理解”你的项目结构，从而提供更相关的补全和回答[28]。对于新手的小项目，索引通常很快完成，不用特殊操作。

以下是Cursor 安装与界面的关键流程截图（示意）：

安装引导界面：选择快捷键和主题。
主界面初始状态：左侧欢迎页，可打开文件夹开始项目。
AI 聊天示例：在 Chat 面板询问代码含义，AI 给出解释。

常见错误

未登录导致无 AI 提示：如果你跳过了账号登录，可能发现AI提示不可用或提示频繁受限。解决：点击界面右上角头像或菜单登录 Cursor 帐户。注册登录可享14天专业版试用，启用所有 AI 功能[8]。
Copilot 无响应：如果选择使用 GitHub Copilot，但未看到补全，可能是未正确登录 GitHub或Copilot订阅无效。解决：确认在 Cursor 设置中启用了 Copilot 模式，并确保本机浏览器已登录 GitHub 且 Copilot 服务可用。[29]另请注意，Cursor 当前不支持 Copilot Chat 窗口，仅支持Copilot补全，且切换模型需重启 Cursor 以重新选择[30][13]。如遇问题，可考虑使用 Cursor 内置AI。
安装问题：Windows 用户若无法启动安装程序，尝试右键以管理员身份运行。macOS 用户如果提示无法打开，可能需要在“系统偏好设置 > 安全性与隐私”中允许。Linux 用户安装 .deb 包可能遇到依赖问题，确保运行 sudo apt --fix-broken install 修复依赖。
界面显示不全或卡顿：Cursor 基于 Electron，初次启动可能稍慢。如果界面元素错位，试着调整窗口大小或重启应用。有时AI响应延迟，检查网络连接或等待索引完成[31]。
AI 补全不准确：初学者代码上下文少时，AI 提示可能牛头不对马嘴。解决：多写注释或函数名提示 AI 意图，或在聊天中明确提问。随着编码熟练，可学习编写更清晰的提示词。

延伸思考

Cursor 与传统编辑器对比：Cursor 将 AI 深度集成开发流程，提高生产力[3]。想一想，相比完全自己查文档，利用 AI 实时建议会带来哪些便利？有没有风险（如过度依赖导致不理解代码）？如何平衡使用AI与自主学习。
Copilot 与 Cursor 模型：Cursor 内置模型目前基于 Anthropic 的 Claude（称为 Sonnet），Pro版还可使用GPT-4[32]。GitHub Copilot 则基于 OpenAI Codex/GPT模型。你可以比较两者在代码补全上的风格差异。例如，同样是def factorial(n):，Cursor vs Copilot 给出的实现是否不同？探究它们各自优劣。
配置与扩展：Cursor 兼容 VS Code 扩展插件[33]。延伸任务：尝试在 Cursor 中安装一个你需要的 VS Code 扩展（例如 Python 插件或主题），感受 Cursor 作为 IDE 的扩展性[34]。考虑哪些插件对AI编码有帮助（如GitLens可显示 Git 更改）。