← 返回 Cursor 教程卡片

Cursor

基于 VS Code 深度定制的 AI 原生代码编辑器：Tab 智能补全、Cmd+K 行内改代码、Composer/Agent 多文件自主编程。

软件本体国内可下载安装；AI 功能与账号体系需特殊网络环境，Pro 订阅需境外银行卡支付。

采集于 2026-10-05 · 关键步骤请以官方最新文档为准

一句话简介：基于 VS Code 深度定制的 AI 原生代码编辑器：Tab 智能补全、Cmd+K 行内改代码、Composer/Agent 多文件自主编程。

主流功能：IDE 内多并行 Agent、Bug 自动修复、云端 Agent

可用性：软件本体国内可下载安装；AI 功能与账号体系需特殊网络环境，Pro 订阅需境外银行卡支付。

适用人群：全栈/前后端开发者：日常编码、重构、修 bug 想提速

前置条件：

系统：Windows 10+ / macOS 10.15+ / 主流 Linux 发行版，4GB+ 内存（建议 8GB+）
网络：能稳定访问境外网络的环境（AI 请求必需
账号：邮箱、Google 或 GitHub 账号用于登录
费用：免费 Hobby 版（每月有限次高级请求，Tab 补全可用）

分步骤教程

第一部分：下载安装（约 10 分钟）

步骤 1：下载安装包

打开官网 https://www.cursor.com（旧域名 cursor.sh 也会跳转），点 Download，网站会自动识别系统：

Windows：.exe 安装程序（Win10/11）
macOS：.dmg（Intel 与 Apple Silicon 通用）
Linux：.deb（Ubuntu/Debian）或 .AppImage

国内下载慢时：可尝试换网络环境后重试，或用 GitHub Release 镜像/第三方可信镜像站搜索 "cursor download"，注意只从可信源下载，避免捆绑软件。

步骤 2：安装

Windows：双击 .exe → 接受协议 → 建议勾选 "Add to PATH"（方便命令行用 cursor 打开项目）→ 下一步完成。
macOS：双击 .dmg → 把 Cursor 拖进 Applications；首次打开若提示"无法验证开发者"，去 系统设置 → 隐私与安全性 点"仍要打开"。

Linux（Debian 系）：

sudo dpkg -i cursor_*.deb
# 依赖缺失时
sudo apt install -f

步骤 3：首次启动与登录

打开 Cursor → 选择界面语言（有中文）→ 可选 "从 VS Code 导入扩展与配置"（一键迁移插件、主题、快捷键）→ 用 邮箱 / GitHub / Google 登录（邮箱方式：收验证码 → 设密码）→ 进入主界面。

第二部分：模型配置

步骤 4：打开模型设置

顶部菜单 设置（齿轮图标）→ Models，或快捷键 Ctrl+, 后左侧选 Models。

步骤 5：选择使用方式（二选一）

方式 A（推荐新手）：用 Cursor 官方模型——登录账号即用，无需配 Key。Pro 订阅用户可在模型下拉框切换 Claude / GPT / Gemini 等；在 Models 页可勾选启用的模型。
方式 B：自带 API Key——点 + Add Model，选择 Provider（OpenAI / Anthropic 等），粘贴 API Key；若使用国内可访问的中转/代理 API，在 Override OpenAI Base URL 中填入中转地址（如 https://你的中转域名/v1），Model Name 填该 Key 对应的模型名（如 gpt-4o），点保存。

提醒：第三方中转站质量参差，涉及代码上传，注意代码隐私；优先用官方订阅。

步骤 6：验证 AI 可用

新建一个 .py 文件，按 Ctrl+K（Mac 为 Cmd+K），输入"写一个快速排序函数"，回车。若成功生成代码，说明 AI 链路通畅。

第三部分：Composer / Agent 上手（核心）

先记住四个快捷键（Mac 把 Ctrl 换成 Cmd）：

快捷键	作用
`Tab`	AI 智能补全（写代码时自动灰色提示，回车接受）
`Ctrl+K`	选中代码 → 自然语言指令直接改这段代码
`Ctrl+L`	打开侧边 AI 对话（Chat）
`Ctrl+I`	打开 Composer（多文件编辑 / Agent 自主编程）

步骤 7：Chat 三种模式

按 Ctrl+L，对话框上方切换模式：

Agent（默认）：全能自主模式——读代码库、改多文件、跑终端命令、报错自动修。适合"做一个登录页""接入支付接口"这类完整任务。
Ask：只读问答——帮你理解代码、查文档，不改文件。
Manual：手动模式——只按你 @ 指定的文件操作，最可控。

善用 @ 引用上下文：@file 指定文件、@folder 指定目录、@Codebase 让 AI 理解整个代码库、@web 联网搜索。

步骤 8：第一个 Agent 任务实战

新建空文件夹并用 Cursor 打开（务必以项目根目录打开，AI 才能索引全项目）。
按 Ctrl+I 打开 Composer，确认模式为 Agent。

输入具体需求（背景+问题+约束，越具体越好）：

用 HTML + CSS + JavaScript 做一个贪吃蛇游戏页面，要求：
1. 有积分统计和最高分记录（localStorage）
2. 有开始/暂停按钮，点击开始后才启动
3. 代码加中文注释，只能用 let/const 声明变量

Agent 会自动创建文件、写代码；可勾选 Auto-run 让它自动运行验证，Auto-fix 让它自动修报错。
生成的代码在 diff 视图里逐项 Accept / Reject；不满意就继续对话追加需求（"加一个难度选择下拉框"）。

步骤 9（进阶）：项目规则 .cursorrules

在项目根目录建 .cursorrules 文件，写清技术栈与规范，AI 每次生成都会遵守：

You are a senior frontend engineer.
1. 使用 TypeScript 严格模式
2. 函数组件 + Hooks，不用类组件
3. 样式用 Tailwind CSS
4. 新组件必须写单元测试

常见问题

AI 对话一直转圈/报错连接失败？ 99% 是网络问题：Cursor 的 AI 服务器在境外，确认代理/网络环境能正常访问境外服务后再试；也可换用方式 B（自带 Key + 国内中转 Base URL）。
Pro 订阅付不了款？ Cursor 只收国际信用卡（Visa/Mastercard）或部分地区的支付方式，国内银联卡/支付宝/微信不支持。可考虑找可信渠道代付，或先用免费版。
免费版额度用完了怎么办？ Hobby 免费版每月有固定次数的高级请求；用完后 Tab 补全仍可用，或等下月重置，或升级 Pro（500 次快速请求/月，超出后按量降速可用）。
Agent 乱改代码/删文件怎么办？ 每次改动都要你 Accept 才落地；重要项目先 git commit 再让 Agent 动手，出问题一键回滚。复杂任务拆小步、逐步验证。
公司代码能传给 Cursor 吗？ 注意隐私合规：免费/Pro 版代码会上传到 Cursor 服务器做推理（官方称不用于训练，可在设置中关"隐私模式"外选项）。涉密项目建议用方式 B 接自己公司的 API 网关，或咨询公司安全政策。

← 返回教程目录