本指南深受 Jack Fields 及其关于为 Python 开发配置 VS Code 的 文章 启发。想了解更多，请查看他的文章。

​
前提条件

开始之前，请确保你已具备：
  • 已安装 Python（推荐 3.8 或更高版本）
  • 用于版本控制的 Git
  • 已安装并更新到最新版本的 Cursor

​
必备扩展

以下扩展可将 Cursor 配置为具备完整的 Python 开发能力。它们为你提供语法高亮、代码检查、调试和单元测试。

Python

来自 Microsoft 的核心语言支持

Cursor Pyright

高性能 Python 语言服务器

Python Debugger

更强大的调试能力

Ruff

Python 代码检查与格式化

​
高级 Python 工具集

尽管以上扩展一直是 Cursor 中最受欢迎的 Python 开发扩展，我们也新增了一些扩展，帮助你把 Python 开发效率拉满。

​
uv - Python 环境管理器

uv 是一款现代的 Python 包管理器，除了用于创建和管理虚拟环境外，还可以替代 pip 作为默认包管理器。 要安装 uv，在终端中运行以下命令： 
pip install uv

​
ruff - Python 代码检查与格式化

Ruff 是一款现代的 Python 代码检查与格式化工具，可用于检查编程错误、帮助执行编码规范，并提供重构建议。它可以与 Black 搭配进行代码格式化。 要安装 Ruff，在终端中运行以下命令： 
pip install ruff

​
Cursor 配置

​
1. Python 解释器

在 Cursor 中配置你的 Python 解释器：
  1. 打开命令面板（Cmd/Ctrl + Shift + P）
  2. 搜索“Python: Select Interpreter”
  3. 选择你的 Python 解释器（如果使用虚拟环境就选对应环境）

​
2. 代码格式化

使用 Black 设置自动代码格式化：
Black 是一款代码格式化工具，会自动把你的代码整理成 统一的风格。它零配置，上手即用，并在 Python 社区被广泛采用。
安装 Black，在终端运行： 
pip install black
然后在你的 settings.json 中加入以下配置，让 Cursor 使用 Black 做代码格式化： 
{
  "python.formatting.provider": "black",
  "editor.formatOnSave": true,
  "python.formatting.blackArgs": ["--line-length", "88"]
}

​
3. Linting

可以用 PyLint 来检查编程错误、执行编码规范，并给出重构建议。 安装 PyLint，在终端运行： 
pip install pylint

{
  "python.linting.enabled": true,
  "python.linting.pylintEnabled": true,
  "python.linting.lintOnSave": true
}

​
4. 类型检查

除了 linting，还可以用 MyPy 做类型检查。 安装 MyPy，在终端运行： 
pip install mypy

{
  "python.linting.mypyEnabled": true
}

​
调试

Cursor 为 Python 提供强大的调试功能：
  1. 点击编辑器侧边栏（gutter）设置断点
  2. 使用 Debug 面板（Cmd/Ctrl + Shift + D）
  3. 配置 launch.json 以自定义调试配置

Tab Completion

懂你意图的智能代码补全

Chat

通过自然对话探索并理解代码

Agent

在 AI 协助下处理复杂的开发任务

Context

从第三方系统引入上下文

Auto-Imports

编码时自动导入模块

AI Review

Cursor 持续用 AI 审查你的代码

​
框架支持

Cursor 可与主流 Python 框架无缝协作：
  • Web 框架：Django、Flask、FastAPI
  • 数据科学：Jupyter、NumPy、Pandas
  • 机器学习：TensorFlow、PyTorch、scikit-learn
  • 测试：pytest、unittest
  • API：requests、aiohttp
  • 数据库：SQLAlchemy、psycopg2