Cursor 是一款 面向开发者的 AI IDE，在 VS Code 体验的基础上，深度集成了代码理解、生成和重构能力。本文通过一个最简单、可复现的示例，介绍如何用 Cursor 从 0 建立一个新工程，并高效完成第一版代码。

---

一、为什么用 Cursor 建新工程？

如果你已经习惯 VS Code，那 Cursor 的优势主要体现在：

• 🧠 对整个工程有上下文理解（而不是只看当前文件）

• ⚡ 适合从 0 到 1：初始化结构、样板代码、配置文件

• 🛠 非侵入式：你仍然在写代码，而不是“被 AI 接管”

典型适用场景：

• 新服务 / 新模块快速起步

• 原型验证（POC）

• 学习新语言 / 新框架

• 写工具类、脚手架、小服务

---

二、准备工作

1. 安装 Cursor

• 官网下载并安装 Cursor

• 启动后登录账号

Cursor 本质上是一个「带 AI 能力的 VS Code」，操作习惯几乎一致。

---

三、创建一个新工程（基础流程）

Step 1：新建并打开目录

1. 本地新建一个空目录，例如：

hello-cursor

1. 使用 Cursor 打开该目录：

• File → Open Folder

• 选择 hello-cursor

此时这是一个 完全空的工程。

---

Step 2：用自然语言描述你要的工程

这是 Cursor 最关键的一步。

按下快捷键：

• Windows / Linux：Ctrl + K

• macOS：Cmd + K

在弹出的输入框中直接描述你的需求，例如：

创建一个使用 Python 的简单命令行程序，目录结构清晰，支持后续扩展

然后选择：

• Generate（生成新代码）

Cursor 会自动：

• 创建目录结构

• 生成基础代码文件

• 给出一个合理的工程骨架

---

四、示例：用 Cursor 创建一个 Python CLI 工程

下面我们做一个完整、但足够简单的示例。

目标

创建一个 Python 命令行工具：

• 命令：hello

• 功能：打印一行问候语

---

Step 1：让 Cursor 生成工程结构

在空工程中，使用 Ctrl/Cmd + K 输入：

创建一个 Python 命令行工具工程，使用 argparse，包含 main 入口

Cursor 通常会生成类似结构：

hello-cursor/
├── main.py
├── README.md
└── requirements.txt

---

Step 2：查看并理解生成的代码

main.py 示例：

import argparse

def main():
    parser = argparse.ArgumentParser(description="Hello Cursor CLI")
    parser.add_argument("--name", default="World", help="Name to greet")
    args = parser.parse_args()

    print(f"Hello, {args.name}!")

if __name__ == "__main__":
    main()

你会发现：

• 代码是可运行的

• 结构是可维护的

• 并且符合 Python 常见规范

---

Step 3：运行验证

在 Cursor 内置终端执行：

python main.py
python main.py --name Cursor

输出：

Hello, World!
Hello, Cursor!

至此，一个完整的新工程已经跑起来了。

---

五、Cursor 的“增量式”使用方式（很重要）

Cursor 最佳实践不是一次性把需求说完，而是：

小步描述 → 生成 → 调整 → 再生成

例如你可以继续对 Cursor 说：

• “帮我把日志改成 logging 模块”

• “增加一个子命令 hello / bye”

• “把参数解析单独拆成一个文件”

Cursor 会基于当前工程上下文进行修改，而不是推倒重来。

---

六、常见使用技巧

1. 用 Cursor 做“项目骨架师”

• 目录结构

• 配置文件

• README 初稿

自己再补核心逻辑。

---

2. 不满意就直接说

例如：

这个结构太复杂，帮我简化

Cursor 会就地重构。

---

3. 明确边界

好的提示往往包含：

• 使用什么语言 / 框架

• 复杂度要求（简单 / 可扩展）

• 是否偏向示例 or 生产代码

---

七、Cursor 与传统 IDE 的区别总结

维度	传统 IDE	Cursor
新工程起步	手写 / 脚手架	自然语言生成
上下文理解	文件级	工程级
重构成本	高	低
学习新技术	查文档	边写边问

---

总结

Cursor 非常适合：

• 🚀 从 0 建工程

• 🧪 快速验证想法

• 🧩 写工具、Demo、小服务

它不是替代你写代码，而是：

帮你把“重复、机械、容易写错的第一步”走完。

剩下的判断、架构和关键逻辑，依然由你掌控。

---