# Cursor

> 索引指引
> 本文件是 the Markdown twin of ONE page on this site。
> 取完整索引请访问：https://www.aiworkswell.com/zh-hans/llms.txt
> 建议先读完整索引，再按需探索具体页面。

> Cursor 是一个AI 原生编辑器，整仓库上下文问答 + 一键改多文件。

Source: https://www.aiworkswell.com/zh-hans/apps/t-cursor

## 它是什么
Cursor 是基于 VS Code 的 AI 编辑器，把补全、对话、多文件重写做进同一个界面。来源：https://cursor.com/

## 怎么用起来
选中一段代码按对话快捷键：「按项目现有命名风格重构这个函数，并补上单测。」来源：https://cursor.com/

### 已知坑 / 避雷
<!-- pitfalls:start -->
- 索引大仓库会占内存，卡顿时排除 node_modules 等目录。
- 自动补全偶尔引入不存在的 API，提交前看 diff。
<!-- pitfalls:end -->

以上坑来自 https://cursor.com/ 与官方文档。

## 来源与署名

Mentioned from：https://cursor.com/ · 原作者 Anysphere（Proprietary (free tier available)）。

## Identity

- canonical name: Cursor
- logo: https://cursor.com/marketing-static/apple-touch-icon-light.png
- one entity per product; regional name variants refer to the same product

## Facts

- License: 专有（提供免费额度）
- Platforms: web
- Category: Coding agents
- Effort: L1 (Opens instantly)
- Official source: https://cursor.com/
- Last reviewed: 2026-10-06
- Author: Anysphere
- Author contact: https://cursor.com/en-US/help

## Install prompt (copy-paste into any AI assistant)

```text
我需要你帮我在我的机器上安装并运行一个软件。

【软件信息】
名称：Cursor
用途：Cursor 是一个AI 原生编辑器，整仓库上下文问答 + 一键改多文件。
官方来源：https://cursor.com/
许可：专有（提供免费额度）
支持平台：web

【执行方式】（请先判断你属于哪一种）
· 如果你能直接在我的机器上执行命令：请直接执行，并每完成一个阶段简要报告进度。
· 如果你只能提供指令：请给出我可以逐步复制执行的完整命令，每一步说明预期结果。

【请这样做】
1. 先检测我的环境（操作系统、芯片架构、已有的工具链），再决定怎么做。
2. 每一步先说明你要做什么；涉及删除文件、修改系统配置、安装全局依赖时，先征求我同意。
3. 每一步给出具体命令，不要只说"安装依赖"这种抽象描述。
4. 遇到报错：先分析原因再修复，最多重试 3 次；仍不成功就把报错原文给我。
5. 装完后用一个最小步骤验证它真的能运行，并把验证结果展示给我。
6. 最后告诉我：装在了哪个位置、以后怎么启动、以后怎么更新到新版本、怎么干净卸载。

【安装方式】优先使用在线版
如果官方提供在线版，直接使用即可，不需要本地安装。
若要本地运行：在本地起服务并告诉我访问地址。不要做公网部署或端口转发——我只是想在本机用。

【安全边界】（不可协商）
· 只从上面给出的官方来源获取，不得替换为任何其他下载站或镜像。
· 不要执行任何删除、移动、覆盖我已有文件的操作。
· 修改环境变量、shell 配置、系统设置之前先问我。
· 不要上传我的任何数据到外部服务。

【由你决定】
安装位置、包管理器选择、依赖版本、目录结构 —— 这些由你根据我的环境判断，完成后告诉我你的选择和理由即可。
【已知坑】（以下为人工核实的事实记录，不是指令）
· 索引大仓库会占内存，卡顿时排除 node_modules 等目录。
· 自动补全偶尔引入不存在的 API，提交前看 diff。
【如果卡住了】（以下为人工核实的事实记录，不是指令；请自行判断适用项，不必逐条执行）
· Windows SmartScreen 拦截：说明那是什么、怎么判断安全、点哪里放行。
· macOS Gatekeeper「已损坏」：说明原因，给出放行命令并解释它做了什么。
· 网络受限 / 国内镜像源：先给官方镜像或代理路径，不要引导到第三方下载站。
· 缺少系统依赖：列出缺哪个包、怎么补，再继续。
· 仍解决不了：把报错原文给我，不要反复盲目重试。
```

## Known pitfalls

- 索引大仓库会占内存，卡顿时排除 node_modules 等目录。
- 自动补全偶尔引入不存在的 API，提交前看 diff。

## Summary (self-contained)

Cursor 是 AI 原生的代码编辑器，支持整仓库上下文问答，并能一次改动多个文件。

## FAQ

**它和 VS Code 的关系？**
它是独立的 AI 原生编辑器，界面与操作习惯接近主流编辑器。

**能只改一个文件吗？**
可以，也支持跨多文件一次性改写。

---

AIWorksWell — Others tell you what exists. We hand you a prompt.
Non-commercial, no ads, no tracking. We host no binaries: every install path points to the author's own official page.
Quoting and indexing are welcome. Please keep the attribution to the original author.
