Python

在 Cursor 中进行 Python 开发的完整配置指南，涵盖必备扩展、代码规范检查和开发工具

本指南深受 Jack Fields 及其关于在 VS Code 中配置 Python 开发环境的文章启发。更多细节可参考他的原文。

前置条件

在开始之前，请确保你已具备以下环境：

• 已安装 Python（建议 3.8 或更高版本）
• 已安装 Git 进行版本控制
• 已安装并更新到最新版的 Cursor

必备扩展

核心 Python 支持

以下扩展可以让 Cursor 拥有完整的 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：

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. 类型检查

除了代码规范检查外，还可以使用 MyPy 检查类型错误。

在终端运行以下命令安装 MyPy：

pip install mypy

{
    "python.linting.mypyEnabled": true
}

调试

Cursor 为 Python 提供了强大的调试功能：

1. 通过点击行号左侧设置断点
2. 使用调试面板（Cmd/Ctrl + Shift + D）
3. 通过 launch.json 文件自定义调试配置

推荐功能

框架支持

Cursor 可无缝支持主流 Python 框架：

• Web 框架：Django、Flask、FastAPI
• 数据科学：Jupyter、NumPy、Pandas
• 机器学习：TensorFlow、PyTorch、scikit-learn
• 测试：pytest、unittest
• API：requests、aiohttp
• 数据库：SQLAlchemy、psycopg2