這份指南深受 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 Linter 與 Formatter

Ruff 是一款現代的 Python linter 與 formatter，可用來檢查程式錯誤、協助落實程式碼規範，並提供重構建議。也能與 Black 搭配進行程式碼格式化。 要安裝 Ruff，在終端機中執行以下指令： 
pip install ruff

​
Cursor 設定

​
1. Python 直譯器

在 Cursor 裡設定你的 Python 直譯器：
  1. 開啟 Command Palette（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