本指南將帶您從安裝開始，到在 Cursor 中完成第一次有用的改動。您將登錄，讓 Cursor 講解你的代碼庫，做一個小改動，並審查結果。
安裝 Cursor 並登錄¶
下載 Cursor，打開應用並登錄。然後選擇一個文件夾，從一項小任務開始。
macOS¶
- macOS 12 (Monterey) 及更高版本
- 原生安裝程序 (.dmg)
- 支持 Apple Silicon 和 Intel
Windows¶
- Windows 10 及更高版本
- 原生安裝程序 (.exe)
Linux¶
Debian/Ubuntu (推薦)
# 添加 Cursor 的 GPG 密鑰
curl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null
# 添加 Cursor 軟件倉庫
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null
# 更新並安裝
sudo apt update
sudo apt install cursor
RHEL/Fedora
# 添加 Cursor 軟件倉庫
sudo tee /etc/yum.repos.d/cursor.repo << 'EOF'
[cursor]
name=Cursor
baseurl=https://downloads.cursor.com/yumrepo
enabled=1
gpgcheck=1
gpgkey=https://downloads.cursor.com/keys/anysphere.asc
EOF
# 安裝 Cursor
sudo dnf install cursor
AppImage (便攜版)
從 cursor.com/downloads 下載 .AppImage 文件，然後：
chmod +x Cursor-*.AppImage
./Cursor-*.AppImage
相比 AppImage，建議優先使用 apt 和 yum 軟件包。它們提供桌面圖標、自動更新和命令行工具。
讓 Cursor 講解你的代碼庫¶
選擇文件夾後，按 Cmd I 打開智能體。讓 Cursor 講解你的代碼庫，並指出應優先閱讀的主要部分。
講解這個代碼庫。指出主要入口點、關鍵模塊，以及在進行更改前我應該閱讀的內容。
Cursor 會搜索您的倉庫、讀取相關文件，並梳理項目的整體結構。這是在陌生代碼庫中快速熟悉情況的方式之一。
想深入瞭解？請參閱瞭解您的代碼庫。
進行一項小更改¶
瞭解項目後，讓 Cursor 推薦幾項安全的小改進。選擇其中一項，並讓它完成更改。
爲這個代碼庫建議三項小而安全的改進。說明其中的取捨，並等待我選擇其中一項。
適合作爲首個任務的是低風險工作，例如優化文案或修復小型 UI 問題。
如果您已經知道想更改什麼，直接提出要求並描述期望結果。
評審 diff 並驗證結果¶
現在您可以觀察 Cursor 如何工作。diff 視圖會顯示智能體所做的更改。
完成後，評審 diff，並讓 Cursor 運行項目現有的檢查，例如測試、類型檢查、lint 或本地構建。
想使用更完善的評審流程？請參閱評審和測試代碼。
對較大更改使用 Plan 模式¶
現在您已經掌握了基礎知識，可以對較大更改使用 Plan 模式。當任務涉及多個文件、需要調研，或需要在編寫代碼前獲得批准時，它尤其適合。
在智能體輸入框中按 Shift+Tab 切換 Plan 模式。Cursor 不會立即編寫代碼，而是會：
- 調研您的代碼庫以查找相關文件
- 就您的需求提出澄清性問題
- 創建詳細的實現計劃
- 在開始實現前等待您的批准
如需深入瞭解，請參閱構建新功能。
後續步驟¶
智能體概覽¶
瞭解智能體的工具和能力
規則¶
爲您的項目創建持續生效的指令
瞭解您的代碼¶
學習如何快速熟悉陌生的倉庫
構建新功能¶
瞭解上線較大更改的完整工作流程
