Cursor 的安装与配置：从零开始打造你的 AI 编程环境

作者：杜有龙
适用人群：前端/后端开发者、AI 编程初学者、独立开发者、技术负责人
关键词：Cursor、AI代码编辑器、安装配置、快捷键、VS Code兼容、大模型编程

Cursor 作为当前最热门的 AI 原生代码编辑器，凭借其强大的上下文理解能力、项目级智能辅助和类 VS Code 的操作体验，迅速成为众多开发者的首选工具。但很多新手在初次使用时，常因不了解安装流程、配置选项或快捷操作而无法发挥其全部潜力。

本文将手把手带你完成 Cursor 的完整安装与配置流程，涵盖：

• 编辑器下载与安装
• 工作空间与扩展管理
• 必备快捷键速查

无论你是 Windows、macOS 还是 Linux 用户，都能轻松上手！

---

一、安装 Cursor 编辑器

1. 下载安装包

访问官方下载页面：
👉 https://cursor.sh

页面会自动识别你的操作系统，并提供对应版本：

• Windows：提供 .exe 安装程序（支持 Win10/11）
• macOS：提供 .dmg 镜像文件（支持 Intel 与 Apple Silicon）
• Linux：提供 .AppImage 或 .deb 包（Ubuntu/Debian 系推荐 .deb）

💡 提示：Cursor 目前仅提供桌面客户端，无网页版。

2. 安装步骤（以各平台为例）

▶ Windows

1. 双击下载的 cursor-setup-x.x.x.exe
2. 按照向导点击“下一步”即可（默认安装路径为 C:\Users\<用户名>\AppData\Local\Programs\Cursor）
3. 安装完成后勾选“运行 Cursor”，点击“完成”

▶ macOS

1. 双击 .dmg 文件
2. 将 Cursor 图标拖拽到 Applications 文件夹
3. 首次启动时，若提示“无法验证开发者”，请前往【系统设置 → 隐私与安全性】中点击“仍要打开”

▶ Linux（Ubuntu/Debian）

sudo dpkg -i cursor-x.x.x.deb
# 若依赖缺失，执行：
sudo apt install -f

或直接运行 AppImage（需赋予执行权限）：

chmod +x Cursor-x.x.x.AppImage
./Cursor-x.x.x.AppImage

3. 首次启动与登录

安装完成后首次打开 Cursor，会要求你：

• 使用 GitHub 账号登录（目前仅支持 GitHub 登录）
• 同意用户协议与隐私政策

登录成功后，你将进入一个干净的编辑器界面，此时 AI 功能尚未启用，需进一步配置模型密钥。

---

二、配置工作空间与扩展

1. 配置 AI 模型（关键步骤！）

Cursor 默认不内置模型，需手动配置 API 密钥才能使用 AI 功能。

操作路径：
顶部菜单栏 → Settings（设置） → 左侧选择 AI → 点击 + Add Model

目前支持以下主流模型：

模型提供商	推荐模型	获取 API Key 地址
OpenAI	GPT-4 Turbo (gpt-4-turbo)	https://platform.openai.com/api-keys
Anthropic	Claude 3.5 Sonnet	https://console.anthropic.com/settings/keys
Ollama（本地）	Llama 3、Qwen、CodeLlama 等	本地部署，无需密钥

配置示例（以 Claude 3.5 Sonnet 为例）：

1. 点击 “+ Add Model”
2. Provider 选择 Anthropic
3. Model Name 填写 claude-3-5-sonnet-20240620
4. 在 API Key 栏粘贴你在 Anthropic 控制台生成的密钥
5. 点击 “Test” 验证连接 → 成功后保存

✅ 建议：首次使用优先选择 Claude 3.5 Sonnet，其在代码理解、长上下文和中文支持方面表现优异，且免费额度较高。

2. 设置工作空间（Workspace）

Cursor 支持标准 VS Code 的工作区管理方式：

• 打开文件夹：File → Open Folder（推荐将整个项目根目录作为工作区）
• 多根目录工作区：File → Add Folder to Workspace 可同时加载多个相关项目
• 保存工作区：File → Save Workspace As... 生成 .code-workspace 文件，便于团队共享配置

⚠️ 注意：Cursor 的 AI 功能依赖于对项目结构的索引，务必以项目根目录打开，否则无法实现跨文件上下文理解。

3. 扩展（Extensions）管理

由于 Cursor 基于 VS Code 构建，完全兼容 VS Code Marketplace 中的绝大多数扩展，包括：

• 语法高亮：如 Python、JavaScript、Go、Rust 等
• 格式化工具：Prettier、Black、ESLint
• Git 工具：GitLens、Git History
• 主题美化：One Dark Pro、Material Theme

安装扩展方法：

1. 左侧活动栏点击 Extensions 图标（方块拼图）
2. 搜索所需插件（如 “Python”）
3. 点击 “Install” 安装
4. 安装后可像在 VS Code 中一样配置 settings.json

🔒 安全提示：部分扩展可能调用网络或本地脚本，请从官方市场安装可信插件。

---

三、基础快捷键速查（提升效率必备）

掌握快捷键是高效使用 Cursor 的关键。以下是最常用的操作组合（Windows/Linux 与 macOS 分列）：

功能	Windows / Linux	macOS
呼出 AI 命令面板	Ctrl + K	Cmd + K
打开命令面板	Ctrl + Shift + P	Cmd + Shift + P
侧边 AI 聊天窗口	Ctrl + L	Cmd + L
选中代码让 AI 解释	右键 → “Ask AI to Explain”	同左
选中代码让 AI 编辑	右键 → “Ask AI to Edit”	同左
查找文件	Ctrl + P	Cmd + P
切换侧边栏	Ctrl + B	Cmd + B
多光标编辑	Ctrl + Alt + ↑/↓	Cmd + Option + ↑/↓
注释代码	Ctrl + /	Cmd + /

💡 特别推荐：

• Cmd/Ctrl + K 是使用频率最高的快捷键，输入自然语言指令即可生成/修改代码
• 在聊天窗口中使用 @filename 可引用任意文件内容（如 @main.py）

---

四、常见问题与优化建议

Q1：安装后 AI 功能不可用？

→ 检查是否已正确配置 API Key，并确保网络可访问 OpenAI/Anthropic 服务。

Q2：能否离线使用？

→ 可通过 Ollama 集成本地大模型（如 qwen:7b、llama3:8b），实现完全离线 AI 编程。

Q3：如何提升响应速度？

• 优先使用 Claude 3.5 Sonnet（比 GPT-4 更快）
• 关闭不必要的扩展
• 在 Settings → AI 中开启 “Use file context only when needed” 减少上下文负载

---

结语

完成以上安装与配置后，你就拥有了一个功能强大、高度智能的 AI 编程环境。Cursor 不仅继承了 VS Code 的生态优势，更通过深度集成大模型，将开发效率推向新高度。

现在，打开你的第一个项目，按下 Ctrl+K（或 Cmd+K），对 AI 说：“帮我写一个读取 JSON 文件并打印用户列表的 Python 脚本” —— 体验未来编程的快感吧！