本指南深受 Jack Fields 及其关于设置 VS Code 以进行 Python 开发的文章的启发。请查看他的文章了解更多详情。

先决条件

在我们开始之前,请确保您已:

  • 已安装 Python(推荐 3.8 或更高版本)
  • 用于版本控制的 Git
  • Cursor 已安装并更新到最新版本

基本扩展

核心 Python 支持

以下扩展将 Cursor 设置为具有 Python 开发的完整功能。这些选项为您提供语法高亮显示、linting、调试和单元测试。

代码质量工具

高级 Python 工具

虽然上述扩展以前是 Cursor 中最受欢迎的 Python 开发扩展,但我们还添加了一些其他扩展,可以帮助您充分利用 Python 开发。

uv- Python 环境管理器

uv 是一个现代 Python 包管理器,除了将 pip 替换为默认包管理器外,还可用于创建和管理虚拟环境。

要安装 uv,请在终端中运行以下命令:

pip install uv

ruff- Python Linter 和 Formatter

Ruff 是一种现代 Python linter 和格式化程序,可用于检查编程错误,帮助实施编码标准,并可以建议重构。它可以与 Black 一起用于代码格式化。

要安装 Ruff,请在终端中运行以下命令:

pip install ruff

游标配置

1. Python 解释器

在 Cursor 中配置 Python 解释器:

  1. 打开命令面板 (Cmd/Ctrl + Shift + P)
  2. 搜索 “Python: Select Interpreter”
  3. 选择您的 Python 解释器(或虚拟环境,如果您使用的是虚拟环境)

2. 代码格式化

使用 Black 设置自动代码格式:

black 是一种代码格式化程序,可自动设置代码格式以遵循一致的样式。它不需要任何配置,在 Python 社区中被广泛采用。

要安装 Black,请在终端中运行以下命令:

pip install black

然后,将 Cursor 配置为使用 Black 进行代码格式化,方法是将以下内容添加到settings.json文件:

{
    "python.formatting.provider": "black",
    "editor.formatOnSave": true,
    "python.formatting.blackArgs": [
        "--line-length",
        "88"
    ]
}

3. PyLint

我们可以使用 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. 通过单击装订线设置断点
  2. 使用调试面板 (Cmd/Ctrl + Shift + D)
  3. 配置launch.json用于自定义调试配置

框架支持

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

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