本指南深受 Jack Fields 及其關於設定 VS Code 進行 Python 開發的 文章 啟發。請查看他的文章以獲得更多詳細資訊。

​
先決條件

在我們開始之前，請確保您已具備：
  • 已安裝 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 程式碼檢查器和格式化工具

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 是一個程式碼格式化工具，會自動格式化您的程式碼以遵循一致的風格。它無需任何配置，並在 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 以自訂除錯設定

​
推薦功能

Tab 補全

理解您操作的智能程式碼建議

聊天

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

Agent

透過 AI 協助處理複雜的開發任務

Context

從第三方系統引入上下文

自動匯入

在您編寫程式碼時自動匯入模組

AI 審查

Cursor 持續使用 AI 審查您的程式碼

​
框架支援

Cursor 與熱門的 Python 框架無縫整合：
  • Web 框架：Django、Flask、FastAPI
  • 資料科學：Jupyter、NumPy、Pandas
  • 機器學習：TensorFlow、PyTorch、scikit-learn
  • 測試：pytest、unittest
  • API：requests、aiohttp
  • 資料庫：SQLAlchemy、psycopg2