Composer
概述
Composer 開發者指南
歡迎使用 Composer
Composer 是一個集成在編輯器中的 AI 編程助手。它可以幫助你探索代碼、編寫新功能以及修改現有代碼，而無需離開你的工作流程。使用 ⌘I 打開它，使用 ⌘N 創建新的 Composer。
Agent
使用 ⌘. 啟用 Agent，獲得一個主動處理你的代碼庫的編程夥伴：
- 自動獲取相關上下文（嘗試
@Recommended） - 運行終端命令
- 創建和修改文件
- 語義化搜索代碼
- 執行文件操作
Agent 在停止前最多可以調用 25 次工具。如果你需要更多，請通過 [email protected] 告訴我們！
目前，Agent 僅支持 Claude 模型。
每個工具操作都會計入你的配額中作為單獨的請求。
普通模式
普通模式提供代碼探索和生成的核心功能：
- 搜索你的代碼庫和文檔
- 使用網絡搜索
- 創建和編寫文件
- 訪問擴展的
@符號命令
使用上下文
輸入 @ 可以查看基於當前工作的上下文選項。使用箭頭鍵導航，按 Enter 選擇，在 @ 後輸入進行過濾。使用 Ctrl/⌘ M 切換文件讀取方法。Agent 中的 @Recommended 會自動獲取相關上下文。
# 文件選擇
使用 # 後跟文件名來關注特定文件。將其與 @ 符號組合使用可以精確控制上下文。
上下文標籤
聊天頂部的標籤顯示活動的上下文。添加或刪除標籤來調整 Composer 可見的內容。使用 # 選擇文件，這些文件會顯示為標籤。
生成和應用更改
當 Composer 建議更改時：
- 在差異視圖中查看更改
- 使用提供的按鈕接受或拒絕更改
- 需要時使用檢查點進行撤銷
檢查點
每次生成代碼時，Composer 都會創建一個檢查點。你可以通過點擊檢查點旁邊的 checkout 返回到任何之前的版本。如果你不喜歡當前的更改想要恢復到早期狀態時，這個功能很有用。
歷史記錄
通過歷史記錄訪問之前的 Composer 會話和聊天。從 Cursor Tab 右側的歷史圖標打開它。你會看到過去的 composer 和聊天列表，你可以重新訪問、重命名或刪除它們。
當 Composer 處於焦點狀態時，使用 ⌘+⌥+L 或 Ctrl+Alt+L 打開。
布局
Composer 提供兩種布局模式：
- 面板：左側是聊天的側邊欄，右側是代碼編輯器。
- 編輯器：單個編輯器窗口，類似於正常查看代碼。你可以移動它、拆分它，甚至將它放在單獨的窗口中。
Beta 功能
迭代處理 lint 問題
Composer 會嘗試修復大多數編程語言中生成代碼的 linting 問題。當啟用此功能時，如果 Composer 檢測到 lint 錯誤，它會嘗試自動修復它們。目前僅支持一次迭代。
某些語言（如 Rust）需要保存文件後才會顯示 lint 錯誤，這可能會限制此功能在所有語言中的有效性。
常見問題
Chat 和 Composer 有什麼區別？
Cursor Chat 幫助你搜索和理解代碼。使用它來探索你的代碼庫、提問和獲取解釋。你可以使用 ⌘⏎ 搜索代碼。
Composer 幫助你編寫和編輯代碼。它提供了一個工作空間，你可以在其中生成新代碼並直接將更改應用到文件中。