Cursor 是基于 VS Code 内核深度重构的 AI 原生代码编辑器，它将大型语言模型（LLM）直接嵌入开发工作流，是目前提升编程效率最热门的工具之一。以下是从零开始的上手到进阶全指南。
一、 下载与安装
1. 下载渠道
务必认准官方渠道，避免第三方修改包：
-
国际官网：cursor.com
-
中国镜像：cursor.ac.cn
官网会自动识别你的操作系统并提供对应安装包（Windows .exe、macOS .dmg、Linux .AppImage/.deb等）。
在 Windows 上安装
-
下载
.exe安装程序（约 80-150MB）。 -
双击运行，按照向导点击"下一步"即可，默认安装路径通常为
C:\Users\{用户名}\AppData\Local\Programs\Cursor。 -
安装完成桌面会生成快捷方式，首次启动需联网下载约 50-80MB 的索引文件。
在 macOS 上安装
-
下载
.dmg镜像文件（Universal 包，同时支持 Intel 和 Apple Silicon 芯片）。 -
打开镜像，将 Cursor 图标拖入
Applications文件夹。 -
首次打开若提示"无法验证开发者"，需前往"系统设置 > 隐私与安全性"点击"仍要打开"。
在 Linux 上安装
-
Ubuntu/Debian（推荐）：通过包管理器安装可获自动更新和桌面图标。
添加 GPG 密钥和仓库
curl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg >/dev/null
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list >/dev/null安装
sudo apt update && sudo apt install cursor
-
AppImage 便携版 ：下载后赋予执行权限运行
chmod +x Cursor-*.AppImage && ./Cursor-*.AppImage。 -
Fedora/RHEL ：可使用提供的
.repo文件通过dnf安装。
二、 首次启动与基础配置
-
登录账号：启动后需登录（支持 GitHub、Google 或邮箱）。新用户通常有免费试用额度或包含一定规模的免费模型调用次数。
-
导入 VS Code 配置 ：强烈建议选择"Import VS Code Settings"。这会一键迁移你的插件、主题、字体、快捷键和用户设置，实现无缝过渡。
-
设置中文界面：
-
按
Ctrl+Shift+X（Mac：Cmd+Shift+X）打开扩展市场。 -
搜索
Chinese (Simplified) Language Pack，点击 Install 安装。 -
重启编辑器即可生效。
-
-
AI 模型设置 ：进入
Cursor Settings（左下角齿轮或Ctrl+Shift+J），在Models或AI选项卡可查看和切换模型（如 GPT-4o、Claude 3.5 Sonnet 等），也可在此配置自定义的 OpenAI 兼容 API Key（如 DeepSeek、Qwen 等国产模型）。
三、 核心 AI 功能与使用详解
Cursor 的精髓在于三种交互模式，熟练掌握它们是效率倍增的关键。
1. 行内编辑（Inline Edit）------ Ctrl+K
用于快速修改当前文件中的代码。
-
操作 ：选中一段代码或光标定位到某处，按
Ctrl+K。 -
效果：弹出一个小型输入框，用自然语言描述你想对这段代码做什么（如"优化性能"、"转成 TypeScript"、"解释这段逻辑"）。
-
接受/拒绝 ：按
Tab接受 AI 生成的修改，按Esc拒绝。
2. 聊天面板（Chat）------ Ctrl+L
用于问答、代码解释和单文件辅助，不直接修改代码（除非你手动应用）。
-
操作 ：按
Ctrl+L打开侧边栏聊天窗。可直接提问，或选中代码后按Ctrl+L将代码作为上下文发给 AI。 -
用途：询问"这个报错怎么修？"、"这个函数的时间复杂度？"、生成代码片段等。
-
@ 符号 ：在聊天中可用
@引用特定文件（@Files）、文件夹或文档，精确控制 AI 的参考上下文。
3. 智能体（Agent / Composer）------ Ctrl+I
这是 Cursor 最强的大杀器，用于多文件、跨项目的复杂任务。
-
操作 ：按
Ctrl+I打开 Agent 面板。 -
能力 ：它不仅能写代码，还能自动创建文件/文件夹、运行终端命令（如
npm install、git操作）、读取报错并自动修复，直到任务完成。 -
Plan 模式 ：在输入框按
Shift+Tab切换。Agent 会先分析代码库，提出澄清问题并生成实现计划，等你确认后才开始写代码，适合大改动。 -
YOLO 模式 ：在设置中开启后，Agent 可自动执行终端命令而无需你每次手动批准（建议配置允许列表，如允许
npm test、mkdir等）。
4. 智能补全（Tab Completion）
像 GitHub Copilot 一样，Cursor 会根据上下文预测你下一行代码甚至整个代码块，按 Tab接受。它的预测能力通常被认为比传统 Copilot 更激进、更懂项目整体上下文。
四、 进阶技巧与最佳实践
-
Rules for AI（项目规则）：
在项目根目录创建
.cursor/rules/文件夹，里面放.md文件（如code-style.md）。你可以在里面写规则，例如"使用 ES Module"、"运行npm run typecheck检查类型"。这些规则会在每次对话时自动注入给 AI，让它在整个项目中遵循统一的代码规范，无需每次提示。 -
上下文管理：
-
不需要手动 @ 所有文件，Agent 有强大的代码库搜索工具（grep/语义搜索），直接说"修改认证流程"它通常能自己找到相关文件。
-
如果 Agent 开始犯傻或迷失，建议开启新对话，避免过长上下文中的"噪音"干扰。
-
-
常用快捷键速查：
-
Ctrl+K：行内编辑 -
Ctrl+L：打开/聚焦聊天 -
Ctrl+I：打开/聚焦 Agent -
Ctrl+Shift+L：将选中代码加入聊天作为上下文 -
Tab：接受 AI 建议/补全 -
Ctrl+Enter：触发更长的补全或强制发送
-
总结 ：Cursor 不是简单的"带 AI 插件的编辑器"，而是将 AI 作为核心交互层的重构。初期建议从 Ctrl+K和 Ctrl+L熟悉，逐步在重构或新建模块时尝试 Ctrl+I的 Agent 模式，并结合 .cursorrules固化团队规范，能极大释放开发生产力。