国内怎么用 Cursor?从下载到写出第一个函数

1

访问官网下载

打开 cursor.com，点击 Download 按钮，选择 Windows/macOS/Linux 版本。文件大小约 200MB，安装过程和普通软件完全一样，一路 Next 即可。

2

注册账号（免费）

打开 Cursor 后会提示注册/登录，用 邮箱注册即可（不需要国外手机号）。新用户有 免费 2 周 Pro 试用，可以先体验完整功能，之后再切换到免费方案。

3

导入你的 VSCode 配置（可选）

首次启动时 Cursor 会询问是否导入 VSCode 的插件、主题、快捷键。强烈建议选「是」——这样你的开发环境瞬间迁移完毕，几乎感受不到切换。

1

打开 Cursor 设置

快捷键 Ctrl + Shift + J（Windows）或 Cmd + Shift + J（Mac）打开 Cursor Settings，或者点右上角齿轮图标 → Cursor Settings（注意，不是普通的 VSCode Settings）。

2

找到 Models 页面，添加自定义模型

在设置左侧点 Models → 找到 Model Names 区域 → 在底部输入框填入：

deepseek-ai/DeepSeek-V3

点击「Add model」按钮添加，然后在列表里勾选启用它。

3

填入 API Key 和 Base URL

在同一个 Models 页面，往下滚动找到 OpenAI API Key 区域：

OpenAI API Key

填入：sk-你的硅基流动Key

OpenAI Base URL (可选)

填入：https://api.siliconflow.cn/v1

填完后点「Verify」或直接关闭，重启 Cursor 使配置生效。

4

验证配置是否成功

按 Ctrl + L 打开右侧 Chat 面板 → 在模型选择下拉框里选 deepseek-ai/DeepSeek-V3 → 输入「你好，你是谁？」如果 DeepSeek 正常回复，配置成功！🎉

在代码文件里，输入函数签名，Cursor 会自动推断你想写什么并给出补全建议，按 Tab 接受，按 Esc 拒绝。

# 你只需要输入这一行：

def parse_csv_and_summary(filepath: str) -> dict:

# Cursor 会自动补全后续的完整函数体

✅ 适合：已知大概怎么写，想加速输出✅ 快捷键：Tab 接受 / Esc 拒绝 / Alt+] 查看下一个建议

光标放在代码文件任意位置，按 Ctrl+K，弹出一个输入框，直接用中文描述你要什么。

# 你在输入框里输入：

"写一个函数，读取 CSV 文件，返回各列的均值、最大值、最小值，处理好异常情况"

Cursor 会直接在你的文件里生成代码，按 Accept 接受，或者继续追加要求：

"再加一个参数，可以指定要分析的列名列表"

✅ 适合：从零生成一段功能代码，或修改现有代码✅ 快捷键：Ctrl+K 唤起 / Enter 提交 / Ctrl+Z 撤销

按 Ctrl+L 打开右侧 Chat 面板。它能看到你整个项目的代码，你可以问任何技术问题，也可以让它帮你调试、重构、生成测试。

# 在 Chat 里问：

"帮我给 parse_csv_and_summary 函数补充单元测试，用 pytest，覆盖空文件和列不存在的 edge case"

# 或者选中一段有 bug 的代码，直接问：

"这段代码在处理 UTF-8 BOM 文件时会报错，怎么修？"

✅ 适合：复杂需求、跨文件分析、Debug、写测试✅ 技巧：选中代码后按 Ctrl+L，AI 自动带入选中内容作为上下文

①

用 @ 符号引用文件或代码

在 Chat 里输入 @文件名 可以引用项目中的具体文件，@web 可以让 AI 搜索互联网。比如：「@utils.py 里的 parse_csv 函数有什么问题？」AI 会直接读取该文件内容来回答。

②

用中文描述需求，效果一样好

DeepSeek 的中文理解能力非常强，不用担心英文表达不准确。描述越具体越好：「写一个分页查询函数，每页20条，支持按创建时间倒序，返回总数和当前页数据」远比「写个查询」好用。

③

配置 .cursorrules 文件，让 AI 了解你的项目

在项目根目录创建 .cursorrules 文件，写入项目的技术栈、规范、风格偏好：「使用 Python 3.11，遵循 PEP8，函数必须有类型注解，错误用 raise 而不是 return None」AI 以后生成的所有代码都会自动遵循这些规则。

④

不要无脑 Accept，要先 Review

AI 生成的代码 大部分是对的，但不是全对的。养成习惯：Accept 之前快速过一遍，重点看：· 边界情况有没有处理（空值、空列表、异常路径）· 命名是否符合你的项目规范· 有没有引入你不需要的新依赖

⑤

用 Composer（Agent 模式）处理复杂任务

按 Ctrl+Shift+I 打开 Composer，这是 Cursor 最强大的模式。你可以告诉它一个完整的功能需求，它会自动：读取多个文件 → 分析依赖 → 修改代码 → 创建新文件，像一个真正的编程助手。

示例指令：「在现有项目里添加一个用户登录功能，使用 JWT，包含 register/login/logout 三个接口，在已有的数据库模型里添加 User 表」

下载安装 Cursor，导入你的 VSCode 配置

注册硅基流动账号，拿到 API Key

在 Cursor 里接入 DeepSeek，发送第一条消息验证成功

用 Ctrl+K 让 AI 写一个你工作中真实用到的小函数

（进阶）在项目根目录创建 .cursorrules，写入你的项目规范