本指南深受 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. 代码检查

我们可以使用 PyLint 来检查编程错误，帮助执行编码标准，并可以建议重构。 要安装 PyLint，请在终端中运行以下命令： 
pip install pylint

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

​
4. 类型检查

除了代码检查，我们还可以使用 MyPy 来检查类型错误。 要安装 MyPy，请在终端中运行以下命令： 
pip install mypy

{
  "python.linting.mypyEnabled": true
}

​
调试

Cursor 为 Python 提供了强大的调试功能：
  1. 通过点击行号槽设置断点
  2. 使用调试面板（Cmd/Ctrl + Shift + D）
  3. 配置 launch.json 以自定义调试配置

​
推荐功能

Tab 补全

理解您操作的智能代码建议

聊天

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

Agent

借助 AI 辅助处理复杂的开发任务

上下文

从第三方系统中获取上下文

自动导入

在编码时自动导入模块

AI 审查

Cursor 持续使用 AI 审查您的代码

​
框架支持

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