Cursor 安装使用教程：从零开始用 AI 写代码

这篇文章教你从零安装 Cursor，并用它完成第一次 AI 辅助写代码。
如果你之前没用过 VS Code、没用过 AI Agent，也可以按这篇教程一步一步走。

图 1：WaveTerm 界面

前面几篇文章讲过 Claude Code、OpenCode、Codex，也单独写过一篇《什么是 AI Agent》。

这篇回到一个更适合新手的入口：Cursor。

Cursor 不是一个单纯的聊天机器人，它是一个带 AI Agent 能力的代码编辑器。你可以把它理解成：

VS Code 加上一个能读项目、改文件、跑命令、解释报错的 AI 助手。

如果你只是想体验“让 AI 帮我写代码、改代码、看项目”，Cursor 通常是最容易上手的一条路线。

本文核心

这篇文章主要讲 8 件事：

Cursor 是什么
Cursor 适合谁
下载和安装 Cursor
登录账号和选择套餐
第一次打开项目
Cursor 里最常用的 4 个功能
怎么给 Cursor 下任务
常见问题和安全提醒

本文主路线很简单：

下载安装 Cursor -> 登录账号 -> 打开一个文件夹 -> 用 Chat / Agent / Tab / Cmd+K 完成第一次 AI 辅助修改。

不讲复杂插件，不讲高级工作流，先把基础跑通。

1. Cursor 是什么

Cursor 是一款 AI 代码编辑器。

它长得很像 VS Code，因为它本来就兼容很多 VS Code 的使用习惯、主题、插件和快捷键。

但它和普通 VS Code 最大的区别是：Cursor 把 AI 放进了编辑器内部。

普通聊天工具通常是这样用的：

你复制一段代码
粘贴到 ChatGPT、豆包、Kimi 里
让 AI 帮你解释或修改
再把结果复制回来

Cursor 的方式更直接：

你打开项目文件夹
Cursor 直接看到项目结构和文件内容
你告诉它目标
它可以在编辑器里帮你改文件
改完你再检查、运行、确认

所以 Cursor 最核心的价值不是“回答问题”，而是“进入项目现场帮你干活”。

如果你已经看过前面的 AI Agent 扫盲文章，这里就很好理解：

普通 AI 是问答。 Cursor 更接近一个坐在你代码编辑器里的 AI Agent。

2. Cursor 适合谁

Cursor 主要适合这几类人：

第一类：完全没写过代码，但想做点小工具的人

比如你想做：

一个简单网页
一个自动整理文件的小脚本
一个批量处理表格的工具
一个微信文章排版辅助脚本
一个本地数据分析小项目

以前你可能卡在第一步：不知道项目怎么建、文件怎么写、报错怎么看。

Cursor 可以降低这个门槛。

你不需要一开始就懂所有代码，只需要把目标说清楚，然后跟着它一步一步改。

第二类：已经会一点代码，想提高效率的人

这类人用 Cursor 会更舒服。

你可以让它：

解释陌生项目
生成函数
补测试
重构代码
查 bug
写文档
根据报错定位问题

以前要自己翻半小时的项目，现在可以先让 Cursor 读一遍结构，再告诉你重点文件在哪里。

第三类：已经在用 VS Code 的人

如果你本来就用 VS Code，迁移到 Cursor 成本很低。

Cursor 可以复用很多 VS Code 的习惯。常见主题、插件、快捷键，大多数都能继续用。

你可以把 Cursor 当成一个“AI 加强版 VS Code”。

3. 下载安装 Cursor

Cursor 官方下载地址：

1
https://cursor.com/download

官方文档入口：

1
https://cursor.com/docs

打开下载页后，Cursor 会根据你的系统推荐安装包。

截至我核对时，Cursor 官方下载页提供 macOS、Windows、Linux 版本。具体版本号、安装包格式和按钮名称，以你打开官网时看到的最新页面为准。

macOS 怎么选

如果你是 Mac，下载页一般会给你几个选择：

Mac ARM64
Mac x64
Mac Universal

简单判断：

Apple 芯片 Mac，比如 M1、M2、M3、M4，优先选 Mac ARM64
Intel 芯片 Mac，选 Mac x64
不想判断，选 Mac Universal，通常也能用，但文件可能更大

下载完成后，按普通 Mac 软件安装方式操作：

打开下载的安装包
把 Cursor 拖到 Applications / 应用程序
从启动台或应用程序里打开 Cursor

如果 macOS 提示“无法验证开发者”或类似安全提示，可以到系统设置里的“隐私与安全性”确认是否允许打开。具体提示会随 macOS 版本变化，以系统当前提示为准。

Windows 怎么选

Windows 下载页常见会有：

Windows x64 System
Windows x64 User
Windows ARM64 System
Windows ARM64 User

普通用户优先选 Windows x64 User。

它一般不需要管理员权限，安装到当前用户目录，对新手更省事。

如果你是公司电脑，权限比较严格，也优先试 User 版本。

如果你明确知道自己电脑是 ARM 架构 Windows，再选 ARM64。

Linux 怎么选

Linux 用户通常已经知道自己系统包管理方式。

官方下载页一般会提供 .deb、RPM、AppImage 等格式：

Ubuntu / Debian 系，优先选 .deb
Fedora / RHEL 系，优先选 RPM
不想安装到系统里，可以试 AppImage

Linux 版本安装细节和发行版有关，按官网当前下载页和系统提示为准。

4. 登录账号和选择套餐

第一次打开 Cursor，一般会让你登录账号。

你可以用邮箱注册，也可以按页面提供的第三方登录方式继续。

Cursor 有免费套餐，也有付费套餐。根据我核对的官方价格页，免费套餐可以体验有限的 Agent 请求和 Tab 补全；Pro、Pro+、Ultra 会给更多额度和更多能力。

这里不要死记价格，因为 AI 工具的套餐变化很快。

你只需要记住：

账号、套餐、额度、价格、支持模型，以 Cursor 官网当前页面为准。

新手建议先用免费版跑通流程。

等你确认自己真的会高频使用，再考虑付费。

不要一上来就为了“必须用最强模型”直接买最高套餐。刚开始你最缺的不是模型额度，而是知道怎么给 AI 下任务、怎么检查它改了什么。

5. 第一次打开项目

安装和登录完成后，不要急着让 Cursor 写一个大项目。

建议先准备一个简单文件夹，比如：

1
my-first-cursor-demo/

然后在 Cursor 里打开这个文件夹。

常见入口是：

1
File -> Open Folder

或者在欢迎页点击类似 Open Folder 的按钮。

打开文件夹后，你会看到左侧文件树。

如果是空文件夹，可以先新建一个文件，比如：

1
README.md

写入一句话：

1
这是我的第一个 Cursor 测试项目。

这样做的目的不是为了写多复杂的代码，而是先让你熟悉 Cursor 的工作方式：

左边是文件
中间是编辑区
右边或侧边可以打开 AI 对话
你可以让 AI 围绕当前项目工作

6. Cursor 里最常用的 4 个功能

Cursor 功能很多，但新手不用一开始全学。

先记住 4 个最常用的就够了。

功能一：Tab 自动补全

Cursor 的 Tab 补全，可以理解成“AI 自动接着写”。

你在文件里写代码、写 Markdown、写配置时，它可能会在光标后面给出灰色建议。

如果你觉得建议对，就按 Tab 接受。

如果你觉得不对，就继续自己写，或者按其他键忽略。

它适合处理这种小任务：

补完一行代码
补完一个函数
延续相同格式
批量写相似结构

比如你正在写一个清单：

1
1. 安装 Cursor
2
2. 登录账号
3
3. 打开项目

它可能会自动建议下一条。

Tab 补全不适合做复杂决策。复杂任务还是交给 Chat 或 Agent。

功能二：Chat 对话

Chat 是你和 Cursor 对话的地方。

你可以问它：

1
请解释一下这个项目的目录结构，告诉我新手应该先看哪些文件。

也可以问：

1
这个报错是什么意思？请用中文解释，并告诉我应该检查哪几个地方。

Chat 适合：

解释代码
解释报错
讨论方案
让它给你列步骤
让它先读项目再总结

如果你只是想问问题，不一定要让它直接改文件，可以先用 Chat。

功能三：Agent 模式

Agent 是 Cursor 最像“办事助手”的地方。

你给它一个目标，它可以自己规划步骤、读取文件、修改代码、运行命令、检查结果。

比如你可以说：

1
帮我创建一个最简单的 HTML 页面，包含标题、介绍文字和一个按钮。创建完成后告诉我改了哪些文件。

或者：

1
帮我检查这个项目为什么启动失败。先不要修改代码，先读报错并给我分析原因。

注意第二个例子里有一句很重要：

先不要修改代码。

新手刚开始用 Agent，建议多加这种限制。

因为 Agent 能干活，也意味着它可能会改文件、跑命令。你要学会把边界说清楚。

功能四：Cmd+K / Ctrl+K 行内修改

在编辑器里选中一段代码或文字，然后按快捷键，可以让 Cursor 直接对选中内容做修改。

Mac 常见是：

1
Cmd + K

Windows / Linux 常见是：

1
Ctrl + K

它适合小范围修改：

把这段文字改得更清楚
给这个函数加注释
把这段代码改成 TypeScript
优化这个 SQL
把中文翻译成英文

如果任务只涉及当前选中的几行，用 Cmd+K / Ctrl+K 通常比打开 Agent 更快。

7. 怎么给 Cursor 下任务

很多人第一次用 Cursor，效果不好，不是因为工具不行，而是任务说得太模糊。

比如你说：

1
帮我做一个网站。

这个任务太大，Cursor 不知道你要什么风格、什么功能、几个页面、用什么技术、做到什么程度。

更好的说法是：

1
帮我在当前文件夹创建一个最简单的个人介绍网页。
2

3
要求：
4
1. 只用 HTML、CSS、JavaScript
5
2. 页面包含头像占位、名字、简介、联系方式、项目列表
6
3. 风格简洁，适合新手学习
7
4. 创建完成后告诉我每个文件的作用
8
5. 不要安装任何依赖

这就清楚很多。

你给 Cursor 下任务时，建议包含 5 个信息：

你要它完成什么目标
当前项目是什么情况
有哪些限制条件
是否允许它修改文件或运行命令
完成后要怎么汇报

可以直接套这个模板：

1
请在当前项目中完成【具体任务】。
2

3
背景：
4
- 这个项目是【项目说明】
5
- 我是新手，请解释关键步骤
6

7
要求：
8
1. 【要求 1】
9
2. 【要求 2】
10
3. 【要求 3】
11

12
限制：
13
- 不要修改无关文件
14
- 不要删除文件
15
- 不要安装新依赖，除非先问我
16

17
完成后：
18
- 总结你改了哪些文件
19
- 告诉我怎么运行或验证

这个模板不只适合 Cursor，也适合 Claude Code、Codex、OpenCode 这类 AI Agent 工具。

8. 学会使用上下文：@ 文件、@ 文件夹、@ 文档

Cursor 里有一个很重要的概念：上下文。

你可以简单理解成：

你希望 AI 重点参考哪些东西。

在对话里，你可以通过 @ 引用文件、文件夹、代码片段或文档入口。具体可用项会随 Cursor 版本变化，以你当前界面显示为准。

常见用法类似：

1
请阅读 @README.md，告诉我这个项目怎么启动。

或者：

1
请重点看 @src 目录，帮我找出用户登录逻辑在哪里。

这比直接说“你看看项目”更准确。

因为项目一大，文件可能很多。你给它明确上下文，它就更不容易跑偏。

如果你不知道该引用哪个文件，可以先问：

1
请先浏览当前项目结构，告诉我为了理解登录功能，应该重点看哪些文件。先不要修改代码。

等它告诉你重点文件后，再继续追问。

9. 建议先写项目规则

如果你打算长期用 Cursor 做一个项目，建议先写一个项目规则文件。

最简单的方式是在项目根目录放一个说明文件，比如：

1
proj.md

里面写清楚：

1
# 项目规则
2

3
## 目录结构
4

5
- src/ 放源码
6
- docs/ 放文档
7
- scripts/ 放脚本
8

9
## 开发要求
10

11
- 默认使用中文回复
12
- 不要删除文件，除非我明确要求
13
- 不要修改 .env
14
- 改完代码后说明验证方式
15

16
## 运行命令
17

18
- 安装依赖：npm install
19
- 本地启动：npm run dev
20
- 检查代码：npm run lint

这样做有两个好处：

你自己不会乱
AI 也更容易按你的规则做事

Cursor 本身也有 Rules 相关能力，可以把规则写到专门的规则文件里，让 AI 在项目里持续遵守。

但新手不用一开始就研究很复杂的规则系统。

先写一个 proj.md，已经能解决很多问题。

等你开始频繁使用 Cursor，再去看官方 Rules 文档。

10. 第一次练习：让 Cursor 做一个小网页

如果你不知道装好以后该干什么，可以用这个练习。

第一步，新建一个空文件夹：

1
cursor-demo

第二步，用 Cursor 打开它。

第三步，打开 Agent 或 Chat，输入：

1
请在当前空文件夹里创建一个最简单的个人介绍网页。
2

3
要求：
4
1. 只使用 HTML、CSS、JavaScript
5
2. 创建 index.html、style.css、script.js 三个文件
6
3. 页面包含标题、个人简介、三个项目卡片、一个点击按钮
7
4. 不要安装任何依赖
8
5. 完成后告诉我每个文件的作用，以及如何在浏览器里打开查看

等它完成后，你重点看 3 件事：

它创建了哪些文件
每个文件内容是否合理
它有没有按要求不安装依赖

然后你可以继续追问：

1
请把页面改成深色风格，并解释你改了哪些 CSS。

再继续：

1
请给按钮增加点击后切换一句欢迎语的功能，代码尽量简单，适合新手理解。

这就是一个完整的入门流程。

不要一开始就让它做“电商平台”“管理后台”“微信小程序”。

先用小任务理解 Cursor 怎么工作。

11. 使用 Cursor 时要注意什么

Cursor 很方便，但不要把它当成完全自动驾驶。

尤其新手要记住下面几条。

不要让它直接碰敏感信息

不要把这些内容直接贴给 AI：

API Key
token
密码
身份证号
支付信息
公司内部代码或客户资料

如果必须展示示例，用这种格式：

1
sk-xxxxxxxxxxxxxxxxxxxxxxxx

Cursor 官方提供 Privacy Mode 等隐私相关能力。根据官方安全页说明，开启 Privacy Mode 后，代码数据不会被模型提供商存储或用于训练。这个功能免费用户和付费用户都可用，团队成员默认开启。

但隐私设置、企业策略和模型供应商规则可能变化，涉及公司项目或敏感代码时，请以 Cursor 官方当前说明和你所在公司的安全要求为准。

不要无脑接受所有修改

AI 改代码很快，但它不是永远正确。

每次改完至少检查：

改了哪些文件
有没有动无关文件
有没有删除重要内容
有没有引入你看不懂的新依赖
能不能正常运行

如果你不懂代码，也要让它解释：

1
请用新手能听懂的话解释你刚才改了什么，为什么这样改。

大任务先让它出方案

如果任务比较大，不要上来就说“直接改”。

先说：

1
请先分析这个需求，给出实现方案和会涉及的文件。先不要修改代码。

等你看懂方案，再让它动手。

这条非常重要。

因为 AI Agent 的能力越强，越需要你先控制方向。

不要让它随便删除文件

删除文件、重置代码、清理历史记录这类操作都要谨慎。

你可以在任务里明确写：

1
不要删除任何文件。如果你认为需要删除，先告诉我原因，等我确认。

这个习惯可以避免很多新手事故。

12. Cursor 和 Claude Code、Codex 怎么选

如果你已经看过前面几篇文章，可能会问：Cursor、Claude Code、Codex 到底该用哪个？

我的建议很简单。

新手优先 Cursor

因为 Cursor 有完整图形界面，编辑器、文件树、AI 对话都在一个地方。

你能直观看到 AI 改了什么。

这对刚开始理解 AI Agent 的人很重要。

习惯命令行再考虑 Claude Code

Claude Code 更适合已经熟悉终端、Git、项目命令的人。

它很强，但对纯小白来说，命令行本身就是一道门槛。

想用 OpenAI 工作流可以看 Codex

Codex 更像 OpenAI 的 AI Agent 工作台。

如果你本来就重度使用 ChatGPT，或者想体验 OpenAI 这一套工作流，可以再看 Codex。

但如果你只是问“我第一次用 AI 写代码，从哪里开始”，答案就是：

先从 Cursor 开始。

13. 常见问题

Cursor 是不是必须会代码才能用？

不是。

但你完全不懂代码时，不要一上来做大项目。

先从小网页、小脚本、小修改开始。

你要把 Cursor 当成一个带你练习的助手，而不是一键生成商业项目的机器。

Cursor 能不能替代程序员？

不能简单这么理解。

Cursor 可以显著提高写代码、读代码、改代码的效率。

但需求判断、方案取舍、安全边界、结果验收，仍然需要人负责。

尤其是真正要上线、收钱、处理用户数据的项目，不能只靠 AI 生成完就直接发布。

Cursor 免费版够不够用？

入门够用。

免费版适合体验基础流程，知道 Cursor 是怎么工作的。

如果你每天都让它读项目、改代码、跑 Agent，很快会需要更多额度。

是否付费，看你的使用频率，不要一开始就冲最高套餐。

Cursor 支持中文吗？

支持。

你可以直接用中文和它对话。

如果你希望它一直用中文，可以在项目规则里写：

1
默认使用中文回复，代码、命令、变量名保留英文。

Cursor 能不能用国产模型？

Cursor 的官方能力和可选模型会随版本、套餐和地区变化。

新手不建议一开始折腾模型接入，先用官方默认模型跑通。

等你熟悉 Cursor 后，再研究自定义模型、OpenAI 兼容接口、第三方网关这类进阶玩法。

Cursor 和 VS Code 插件兼容吗？

Cursor 兼容很多 VS Code 插件和设置，但不是每一个插件都保证完全一致。

如果你是从 VS Code 迁移，可以先导入常用设置和插件，再逐个确认是否正常。

14. 总结

这篇文章你只需要记住一条主线：

Cursor 是最适合新手入门 AI 写代码的工具之一。

它不像纯聊天工具那样需要你来回复制粘贴，也不像纯命令行 Agent 那样一开始就要求你熟悉终端。

它把编辑器、项目文件、AI 对话和 Agent 能力放在一起。

新手入门建议按这个顺序走：

下载安装 Cursor
登录账号
打开一个空文件夹
让它创建一个简单网页
看懂它改了哪些文件
学会用 Chat 提问
学会用 Agent 做小任务
学会在大任务前让它先出方案
给长期项目写规则

不要一开始追求复杂玩法。

先让 Cursor 帮你完成一个很小但真实的任务。

完成一次，你就知道 AI Agent 到底是怎么进入工作现场的。

晴天录