本指南深受 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: 选择解释器”
  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 以进行自定义调试配置

框架支持

Cursor 与流行的 Python 框架无缝协作

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

此页面对您有帮助吗?