Cursor — AI 原生编程 IDE¶

# === 方法一：官网下载（推荐） ===
# 1. 打开浏览器访问 https://cursor.com
# 2. 点击 "Download" 按钮
# 3. 选择你的操作系统版本下载
# 4. 安装完成后打开 Cursor

# === 方法二：Linux 命令行安装 ===
# 下载 AppImage（Linux）
wget https://downloader.cursor.sh/linux/appImage/x64 -O cursor.AppImage  # 下载 Cursor 的 Linux 版本
chmod +x cursor.AppImage  # 给文件添加执行权限
./cursor.AppImage  # 运行 Cursor

首次启动 Cursor 后：
1. 选择 "Import from VS Code" — 一键导入你的 VS Code 设置、插件、主题
2. 登录账号 — 用 GitHub 或 Google 账号登录
3. 选择模型 — 默认使用 Claude Sonnet，也可切换其他模型
4. 设置代理（中国用户） — Settings → HTTP Proxy → 填入你的代理地址

操作步骤：
1. 打开 Cursor，新建一个文件夹项目
2. 按 Ctrl+L（或 Cmd+L）打开 AI 对话框
3. 输入："帮我写一个 Python 脚本，读取 CSV 文件并画柱状图"
4. AI 会自动生成代码、创建文件、安装依赖
5. 按 "Accept" 接受修改，或 "Reject" 拒绝

# 1. Tab 补全 — 写代码时自动补全（像 GitHub Copilot）
#    直接写代码，AI 会预测你要写什么，按 Tab 接受

# 2. Ctrl+K 内联编辑 — 选中代码，告诉 AI 怎么改
#    选中一段代码 → 按 Ctrl+K → 输入"加上错误处理" → AI 直接修改

# 3. Ctrl+L 对话模式 — 跟 AI 聊天，让它帮你干活
#    按 Ctrl+L → 输入任务描述 → AI 理解你的项目后给出方案

Agent 模式是 Cursor 最强大的功能，使用方法：

1. 按 Ctrl+L 打开对话框
2. 确认左上角显示 "Agent" 模式（不是 "Ask" 模式）
3. 输入高层次任务，比如：
   "给这个项目加一个用户登录功能，用 JWT 认证"
4. Agent 会自动：
   - 分析你的项目结构
   - 创建/修改多个文件
   - 安装需要的依赖包
   - 运行代码检查是否正确
   - 修复发现的错误
5. 你只需要审查和确认

Cursor 会索引你的整个项目，所以你可以问：
- "这个项目的数据库连接在哪里配置的？"
- "找出所有调用了 getUserById 函数的地方"
- "@文件名.py 这个文件里的 process_data 函数做了什么？"

使用 @ 符号引用特定文件、文件夹或文档：
@file.py      — 引用某个文件
@folder/      — 引用整个文件夹
@docs         — 引用项目文档
@web          — 让 AI 联网搜索

当你有一个大任务时：
1. 输入任务描述
2. 点击 "Build in Parallel"
3. Cursor 会把任务拆分成独立部分
4. 同时使用多个子 Agent 并行处理
5. 需要串行的步骤会自动保持顺序

Cursor 内置了 BugBot 代码审查工具：
- 自动检查你的 PR（Pull Request）
- 发现潜在的 Bug 和安全问题
- 从你的反馈中学习，减少误报
- 当前解决率接近 80%

当你改了很多东西时：
1. 使用快捷操作 "Split into PRs"
2. Cursor 会分析你的改动
3. 自动把改动拆分成多个独立的 PR
4. 创建备份快照
5. 提出拆分方案等你确认

旧版 .cursorrules 文件已弃用，新版使用 .cursor/rules/*.mdc 文件：

1. 在项目根目录创建 .cursor/rules/ 目录
2. 创建 .mdc 规则文件，例如 python-style.mdc：

---
description: Python 后端开发规范
globs: "**/*.py"
alwaysApply: false
---

你是一个 Python 后端开发专家。
- 使用 Python 3.11+ 语法
- 所有函数必须加 type hints
- 使用 pytest 写测试
- 代码注释用中文
- 遵循 PEP 8 规范

优势：可以按文件类型自动加载规则，节省上下文 token