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

上一篇说了：今天就做一件事——打开 Cursor，用它写完第一个函数。好，那这篇就是那件事的完整执行手册。国内用户会碰到的坑，我都帮你踩过了。

⚠️ 本文适合谁：已有编程基础（任意语言都行），想把 AI 融入日常开发的程序员。全程 不需要翻墙，使用 硅基流动 × DeepSeek 的免费方案，零月费。

01	下载安装 Cursor 5分钟搞定

Cursor 官网在国内访问 完全没有问题，直接下载安装即可。

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

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

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

✅ 安装验证：打开后界面和 VSCode 几乎一模一样，右下角或侧栏能看到 AI 图标，说明安装成功。

02	接入 DeepSeek（国内免费方案）核心步骤，别跳过

Cursor 自带的 AI 模型（GPT-4o、Claude 等）需要翻墙才能用，免费额度也有限。国内最佳方案是：接入硅基流动的 DeepSeek 模型——国内服务器，响应极快，新用户送 50 万 token 免费额度。

第一步：在硅基流动申请免费 API Key

Step 1

打开 siliconflow.cn，注册账号

手机号直接注册，实名认证后可领更多免费额度（无需付费）。

Step 2

进入「API密钥」页面 → 新建密钥

登录后左侧菜单找到「API密钥」，点「新建API密钥」，复制生成的 Key（格式类似 sk-xxxxxxxxxxxxxxxx），妥善保存，只显示一次。

Step 3

记住这两个信息（等会儿要填到 Cursor）

Base URL：https://api.siliconflow.cn/v1

API Key：sk-你刚才复制的那串

第二步：在 Cursor 里配置 DeepSeek 模型

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 正常回复，配置成功！🎉

常见报错速查

报错信息	原因 & 解决方法
`401 Unauthorized`	API Key 填错了，检查有没有多余空格或漏字符
`404 Not Found`	模型名字拼错，确认是 `deepseek-ai/DeepSeek-V3`
`Connection Error`	Base URL 末尾不能加斜杠，正确写法：`https://api.siliconflow.cn/v1`
响应很慢	免费额度并发有限，高峰期正常，稍后重试或换付费档

03	写出今天的第一个函数 3种用法，从简单到牛逼

Cursor 有 3 个核心 AI 功能，分别对应 3 种使用场景。我用同一个例子来演示——写一个解析 CSV 文件、统计数据的 Python 函数。

用法 ①

Tab 补全——最轻量的用法

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

# 你只需要输入这一行：

def parse_csv_and_summary(filepath: str) -> dict:

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

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

用法 ②

Ctrl+K 内联生成——直接在代码里对话

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

# 你在输入框里输入：

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

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

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

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

用法 ③

Ctrl+L 对话窗口——带上下文的深度问答

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

# 在 Chat 里问：

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

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

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

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

04	5 个让 Cursor 更好用的实用技巧新手必看

①	用 @ 符号引用文件或代码在 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 表」

05	快捷键速查表截图收藏

快捷键	功能	使用场景
`Tab`	接受 AI 补全	日常编码，最高频
`Ctrl + K`	内联生成/修改代码	不想离开代码区时
`Ctrl + L`	打开 Chat 对话	复杂问题、调试
`Ctrl + Shift + I`	Composer（Agent）	跨文件、大功能开发
`Ctrl + Shift + J`	Cursor 设置	模型配置、API 设置
`选中代码 + Ctrl+L`	带代码上下文问 AI	解释代码、找 Bug

📌 今日作业（30分钟完成）

1.	下载安装 Cursor，导入你的 VSCode 配置
2.	注册硅基流动账号，拿到 API Key
3.	在 Cursor 里接入 DeepSeek，发送第一条消息验证成功
4.	用 Ctrl+K 让 AI 写一个你工作中真实用到的小函数
5.	（进阶）在项目根目录创建 `.cursorrules`，写入你的项目规范

🚀

工具本身不重要，习惯才重要

Cursor 不是一个魔法棒，它是一个倍增器。你越懂，它越好用；你的 Prompt 越准，它给的越对。

从今天起，试着用 AI 写完你工作里最无聊的那个函数，然后你会发现——省下来的时间，才是真正属于你的时间。

下期预告：如何用 Cursor Composer 从零搭建一个完整的副业项目