一、Cursor 简介
Cursor 是基于 VS Code 内核深度重构的原生 AI 代码编辑器，内置 Claude、GPT-4o 大模型，区别于 VS Code 插件式 AI，可直接读取整个项目上下文、跨文件自动修改代码、全自动调试项目，覆盖代码生成、重构、查 Bug、写文档、搭建项目全流程，支持 Windows/macOS/Linux 全平台，前端、后端、移动端、脚本开发通用。
核心优势
原生 AI 集成，无需额外安装插件；
Agent 智能代理模式，自动读写多文件完成完整需求；
全局代码库理解，支持 @文件/@文件夹 精准限定上下文；
多行智能 Tab 补全，跨行代码预测；
兼容 VS Code 所有插件、快捷键、配置文件，零学习迁移成本。
二、安装与初始化配置
下载安装
打开官网：https://cursor.sh / https://www.cursor.com/cn
网站自动识别系统，点击下载对应安装包：
◦ Windows：.exe 安装包，双击一路下一步，自定义安装路径，勾选桌面快捷方式；
◦ macOS：.dmg 文件，拖入「应用程序」；首次打开提示无法验证时，前往系统设置-隐私与安全性允许运行；
◦ Linux：AppImage 文件，执行 chmod +x xxx.AppImage 添加权限后运行。
2. 登录账号（必须登录才能使用AI）
启动后三种登录方式：GitHub、Google、邮箱注册，推荐 GitHub 登录，方便代码仓库联动。
免费账号拥有每日基础 AI 额度，付费 Pro 解锁无限 Claude 3.5、长上下文 Agent 功能。
3. 基础初始化设置
快捷键方案：可选 VS Code / IntelliJ / Sublime 风格，用过 VS Code 直接选 VS Code；
界面语言汉化：
快捷键 Ctrl+Shift+P（Mac Cmd+Shift+P），输入 Configure Display Language，选择 zh-cn，重启编辑器；主题与字体：内置深浅两套主题，可同步 VS Code 自定义字体；
导入VS Code配置：设置内一键导入原有插件、快捷键、格式化规则，无缝切换。
AI模型选择（设置→Models）
• Claude 3.5 Sonnet（默认推荐）：代码逻辑最强、注释规范、长项目上下文稳定，开发首选；
• GPT-4o：响应速度更快，适合快速写小工具、脚本；
• Gemini：轻量化，适合低配置电脑。
三、界面基础认知
整体布局和 VS Code 高度一致，新增右侧专属 AI 聊天面板：
左侧：文件资源管理器、搜索、Git、扩展插件；
中间：代码编辑区，支持多标签分屏；
底部：终端、调试控制台、输出日志；
右侧（核心）：AI Chat 对话窗口，承载所有 AI 交互。
四、四大核心AI功能（附快捷键+实操案例）内联代码编辑 Ctrl/Cmd + K（高频日常）
作用：选中一段代码，直接在代码行内下发指令，局部修改、重构、优化、加注释。
使用步骤
框选需要处理的代码；
按下 Ctrl+K，弹出输入框；
输入自然语言指令，回车生成，点击 Accept 确认修改。
常用指令示例
• 给所有函数添加JSDoc注释；
• 优化这段代码，降低时间复杂度；
• 增加参数校验和异常捕获；
• 改成异步async/await写法；
• 提取公共工具函数。
2. 全局AI聊天面板 Ctrl/Cmd + L（查Bug、读项目、写文档）
作用：独立对话窗口，支持读取整个项目、引用指定文件、分析报错、代码评审、生成接口文档。
关键语法：@ 上下文引用（最实用技巧）
• @main.js：单独引用某一个文件作为AI参考；
• @src：引用整个src文件夹，让AI读懂完整项目架构；
• @error.log：粘贴报错日志，搭配文件一键定位BUG根源。
实操场景
读不懂项目：@src 给我梳理整个项目架构、数据流、技术栈；
修复报错：粘贴控制台报错 + @api/user.js 找出这段接口崩溃原因并修复；
代码评审：@order.ts 评审这段代码，列出所有隐患并给出优化方案；
生成文档：@所有接口文件 输出Markdown接口文档。
Agent 智能代理 Ctrl/Cmd + I（最强功能，全自动开发）
作用：Cursor 独有核心能力，AI 不再只返回文本，可自动读取、新建、修改、删除项目内多文件，完整实现一套功能，适合搭建页面、新增模块、重构项目。
实操流程
按下 Ctrl+I，输入完整需求；
AI 自动扫描项目现有代码、依赖、目录结构；
自动创建/修改多个文件，生成配套样式、接口、工具类；
预览全部改动，一键全部接受或单独取舍文件修改。
需求示例
基于Vue3+Vite，新增用户登录页面，包含表单校验、登录接口、本地token存储；
给当前Python项目写单元测试，覆盖所有工具函数；
重构整个后端用户模块，拆分controller/service/model分层。
Tab 智能多行补全（无需快捷键，自动触发）
作用：实时上下文代码预测，支持跨行、跨函数生成，写完注释直接按Tab补全完整逻辑。
使用技巧
• 单行补全：出现灰色预测文字，按 Tab 一键接收；
• 逐字接收：Ctrl+→，只采纳部分补全内容；
• 拒绝补全：直接继续打字自动取消；
• 进阶：写注释 // 冒泡排序实现，光标换行按Tab直接生成完整函数。
五、项目级高级技巧
- .cursorrules 项目规则文件（统一AI输出规范）
在项目根目录新建 .cursorrules 文件，写入项目统一开发规范，AI 全程遵循规则生成代码，避免每次重复描述要求。
模板示例
项目技术栈：Vue3 + TypeScript + Element Plus + Vite
编码规范：
所有组件使用setup语法糖，interface定义类型；
请求统一封装axios，错误统一拦截；
函数必须添加注释，变量采用小驼峰；
禁止any类型，严格定义接口；
代码格式遵循eslint规则。
终端联动AI
终端报错后，复制报错信息，打开 Ctrl+L 聊天框，AI 自动分析命令错误、给出修复指令；
Agent模式可自动执行npm/pip命令安装依赖、初始化项目。
调试辅助
打断点运行报错后，选中报错堆栈，Ctrl+K 让AI定位逻辑漏洞；
Ctrl+L 传入调试日志，自动梳理代码执行流程，排查逻辑Bug。
批量重构全项目
使用 Ctrl+I Agent模式，输入指令：全局把var替换为const/let，统一接口请求格式，删除无用注释和console.log，AI自动遍历所有文件批量修改。
六、高频快捷键速查表（Windows/mMac区分）
功能 Windows快捷键 Mac快捷键
打开AI聊天面板 Ctrl + L Cmd + L
内联代码修改 Ctrl + K Cmd + K
Agent全自动多文件操作 Ctrl + I Cmd + I
接受Tab代码补全 Tab Tab
逐字接收补全 Ctrl + → Cmd + →
打开命令面板 Ctrl + Shift + P Cmd + Shift + P
切换中文语言 Ctrl+Shift+P输入Configure Display Language 同上
新建终端 Ctrl +Cmd +
格式化代码 Shift + Alt + F Shift + Option + F
七、常见问题与优化方案
AI读取文件不全，回答不准确
解决方案：聊天框使用 @文件夹 指定完整上下文，项目根目录添加 .cursorrules 限定规范，Pro版解锁超大上下文。Tab补全不触发
设置 → AI 开启「Auto Complete」，关闭VS Code同类补全插件冲突。运行卡顿、内存占用高
关闭未使用的文件标签，Agent模式不要一次性下达超大重构需求，分模块执行。免费额度不够用
优化提示词精准度，减少无意义对话；升级Pro套餐解锁无限AI调用。中文乱码/界面英文
通过命令面板安装中文语言包，重启编辑器即可。
八、完整实战流程（新手快速上手）
安装并登录Cursor，切换中文界面；
打开已有项目/新建空白项目；
根目录创建 .cursorrules 写入项目技术规范；
写需求：Ctrl+I 调用Agent，输入搭建页面/模块需求，AI自动生成全套代码；
局部优化：选中代码 Ctrl+K 做注释、性能优化；
遇到报错：Ctrl+L 打开聊天，@对应文件 + 报错日志，一键修复；
完成开发：让AI生成接口文档、单元测试。
九、总结
Cursor 是目前生产力最高的 AI 原生编辑器，核心在于Agent多文件自动操作与全项目上下文理解。新手优先掌握 Ctrl+L、Ctrl+K、Ctrl+I 三大快捷键，搭配 @文件 上下文语法与 .cursorrules 规则文件，可大幅降低重复编码、排错、重构成本，适配前后端、脚本、移动端所有开发场景。