用途：Cursor 是基于 VS Code 的 AI 原生代码编辑器，用于 AI 辅助软件工程、多文件代码生成与上下文感知的代码库探索。
主要能力：通过 Cursor Composer 进行多文件代码编辑；对代码库进行预测性索引，可用 @codebase 提出架构问题；用 .cursorrules 定义项目约定、技术栈与测试规则；在终端与编辑器内用内联 AI 提示解决编译错误、堆栈跟踪与 linter 警告。
使用方式：在项目根目录创建 .cursorrules 提供持久化智能体指令，例如要求使用严格 TypeScript、React 19 函数组件、为每个新辅助函数写 Vitest 测试、不写解释显而易见代码的注释。用 @ 指令注入精确上下文，如 @codebase、@middleware.ts、@src/auth/session.ts、@docs/security-guidelines.md。在 Composer 中跨架构边界提示，例如把旧 User REST 端点重构为 Server Actions：创建 app/actions/user.ts 并加 Zod 校验、更新 app/profile/page.tsx 用 useActionState 调用、删除 app/api/user/route.ts、在 tests/actions/user.test.ts 加单测。
适用场景：AI 原生开发、上下文感知的代码库探索、自动化规则执行、终端与编辑器内调试。
限制与注意：不要向 AI 提供数据库密码、生产 API 密钥或私有客户数据；接受多文件 Composer 变更前应仔细审查 diff 并运行测试套件（npm test）；用 @file、@docs、@symbol 替代 @codebase 可减少 token 噪声与成本；用 .cursorignore 排除生成文件、.env 密钥与构建输出。排错：索引卡住需在 .cursorignore 添加构建目录与二进制文件；.cursorrules 被忽略通常是文件位置或命名错误，须在项目根目录精确命名为 .cursorrules；内联编辑 diff 被拒可对最新文件状态用 Cmd+K / Ctrl+K 重跑。官方网址为 Cursor Website。