這份指南深受 Jack Fields 與他那篇 關於設定 VS Code 進行 Python 開發的 文章 啟發。想了解更多細節，去看看他的文章吧。

​
先決條件

開始之前，先確認你已經具備：
  • 已安裝 Python（建議使用 3.8 或以上版本）
  • 版本控制工具 Git
  • 已安裝並更新到最新版本的 Cursor

​
必備擴充功能

以下擴充功能會把 Cursor 設定成完整支援 Python 開發。它們提供語法高亮、靜態檢查、除錯與單元測試。

Python

Microsoft 提供的核心語言支援

Cursor Pyright

高速的 Python 語言伺服器

Python Debugger

強化的除錯功能

Ruff

Python 的 linter 與 formatter

​
進階 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. 點擊編輯器邊欄設定中斷點
  2. 使用 Debug 面板（Cmd/Ctrl + Shift + D）
  3. 設定 launch.json 以自訂除錯組態

Tab Completion

能理解你操作的智慧程式碼補全建議

Chat

透過自然對話探索並理解程式碼

Agent

在 AI 協助下處理複雜的開發任務

Context

從第三方系統擷取脈絡

Auto-Imports

撰寫程式碼時自動匯入模組

AI Review

Cursor 以 AI 持續審查你的程式碼

​
框架支援

Cursor 可與主流 Python 框架無縫配合：
  • 網頁框架：Django、Flask、FastAPI
  • 資料科學：Jupyter、NumPy、Pandas
  • 機器學習：TensorFlow、PyTorch、scikit-learn
  • 測試：pytest、unittest
  • API：requests、aiohttp
  • 資料庫：SQLAlchemy、psycopg2