這是 cursor 的設計主管在 X 上發(fā)布的 cursor 使用建議

地址：https://x.com/ryolu_/status/1914384195138511142

訪問不了的可以直接看下面的截圖

第一條，提前編寫 cursor rules

Set 5-10 clear project rules upfront so Cursor knows your structure and constraints. Try /generate rules for existing codebases.

提前設定 5-10 條清晰的項目規(guī)則，這樣 Cursor 就能了解你的結構和限制。嘗試使用/generate 規(guī)則來處理現(xiàn)有代碼庫。

提前寫好 cursor rules ，如果是新項目， 在項目開始之前你就要把 cursor rules 編寫好，就像給 Cursor 一份“項目章程”。這樣做可以從一開始就引導 AI 生成更符合項目需求的代碼，減少后續(xù)的修改工作。

如果說你用 cursor 打開的是一個已有的項目代碼時，可以使用 /generate rules 讓 Cursor 嘗試從現(xiàn)有代碼中推斷這些規(guī)則。

使用這個命令之后 cursor 就會基于你的項目為你定制一些具體的規(guī)則，這一步的作用就是給 AI 設定明確的編碼規(guī)范和項目約束。

比如讓 cursor 知道你的代碼風格（縮進、命名約定）、禁止使用的庫、特定的設計模式、錯誤處理方式等。

第二條，提示詞要具體

Be specific in prompts. Spell out tech stack, behavior, and constraints like a mini spec.

提示詞要具體，詳細列出技術棧、行為和限制，就像一個迷你規(guī)范一樣。

模糊的指令會導致模糊的輸出，我們在給 cursor 任務指令的時候，要盡可能清晰、具體。

不要只說“創(chuàng)建一個登錄頁面”，而要說“使用 React、Tailwind CSS 和 Firebase Auth 創(chuàng)建一個登錄頁面，包含郵箱和密碼輸入框，一個登錄按鈕，以及忘記密碼鏈接。登錄成功后跳轉到 /dashboard，失敗則顯示錯誤信息。”

這就像給開發(fā)者寫一個小型需求文檔 (mini spec)，當你給 cursor 一個指令的時候，你要想想假如他是一個人類開發(fā)者，他能不能聽的明白。

一個小技巧：

可以在 Ask 模式下，把我們說的自然語言轉換成結構化的提示詞

然后再切換到 Agent 模式，把剛才得到的結構化提示詞粘貼進去

所以我們盡量要把提示詞的詳細具體，你的提示詞越接近一個清晰的需求文檔，Cursor 生成的代碼就越接近你的期望。明確技術棧（如 Python Django, React, Vue.js）、期望行為（用戶操作流程、功能邏輯）和任何限制條件（如性能要求、特定庫版本）。

第三條，處理維度盡量小

Work file by file; generate, test, and review in small, focused chunks

直譯：按照單個文件維度一個一個去處理，用小而集中的模塊為單位進行生成、測試和審查

意譯：按照單個文件維度推進工作，將代碼生成、測試驗證和審查環(huán)節(jié)都控制在專注的小功能模塊范圍內，確保每個環(huán)節(jié)的質量可控。

我們在使用 cursor 的時候，不要試圖讓 Cursor 一次性生成整個應用程序或一個非常復雜的功能。而是要把任務分解成更小的、可管理的部分，最好是逐個文件或逐個小模塊進行。每生成一小部分代碼，就立即進行測試和審查。

我們可以采用增量開發(fā)的方式。例如，先讓 Cursor 生成一個數(shù)據模型，審查通過后，再讓它生成相關的 API 接口，再到前端組件。這種小步快跑、及時反饋的方式更容易控制代碼質量，也更容易定位和修復問題。

第四條，測試驅動開發(fā)

Write tests first, lock them, and generate code until all tests pass.

直譯：先編寫測試用例并鎖定，隨后生成代碼直至全部測試通過。

意譯：遵循測試驅動開發(fā)(TDD)原則：首先明確需求并編寫自動化測試用例，將這些測試用例作為驗收標準鎖定后，再通過迭代編碼持續(xù)滿足測試要求，最終確保所有測試用例100%通過。

這是測試驅動開發(fā) (TDD) 的理念在 AI 輔助編程中的應用。先編寫單元測試來定義代碼應該如何工作（即“鎖定”期望的行為），然后讓 Cursor 生成實現(xiàn)這些功能的代碼，直到所有測試都通過。

比如說你想實現(xiàn)一個功能，那你一開始就可以讓 AI 幫你想一些測試場景，然后把測試用例作為驗收標準，讓 cursor 去生成代碼，最后生成的代碼要保證所有的測試用例都能通過。這樣的話，cursor 就有一個非常明確的目標，當所有測試用例都通過時，AI 生成代碼的正確性也會大大提高，也可以顯著減少手動調試和驗證的時間。

第五條，人工審查并提供范例

Always review AI output and hard?fix anything that breaks, then tell Cursor to use them as examples.

直譯：始終審查AI生成內容，對發(fā)現(xiàn)的問題進行人工修復，并將修正后的案例作為示例提供給Cursor。

意譯：建立AI代碼質量閉環(huán)機制：1) 系統(tǒng)審查Cursor生成的代碼 2) 對發(fā)現(xiàn)的問題進行人工修正并記錄 3) 將修正后的標準案例記錄到文檔中或者 Project Ruels 中  4) 引導Cursor學習優(yōu)化

Cursor 生成的代碼可能會出現(xiàn)幻覺或者不符合你的意圖，這個時候人工審查就至關重要了，當你發(fā)現(xiàn)問題并手動修正后，關鍵還要讓 Cursor 從你的修正中學習，將這些修正作為后續(xù)代碼生成的“正面教材”。

你糾正 cursor 錯誤之后，要明確告訴它：“下次遇到類似情況，請參考我剛才的修改。” 這樣可以逐步提升 Cursor 在你特定項目中的表現(xiàn)，使其越來越懂你的偏好和項目需求。

案例：

我現(xiàn)在讓 cursor 幫我創(chuàng)建一個 index.html 頁面，它創(chuàng)建出來的 h1 標簽一般都這么寫，但是我覺得這么寫不符合我的要求，我希望的 h1 標簽是「歡迎來到 hepingfly的網站」

那么我就可以把這個生成 index.html 的規(guī)則寫在 Project Rules 中

現(xiàn)在我再讓 cursor 生成一個 index2.html 頁面，你會發(fā)現(xiàn)它的 h1 標簽內容就是「歡迎來到 hepingfly的網站」

如果說你希望這個規(guī)則不僅在當前項目中使用，在以后所有的項目中都使用這個規(guī)則的話，你就可以把這個 Project Rules 升級一下，升級成 User Rules

以后只要你打開 cursor ，它就會應用這個規(guī)則

第六條，限定上下文

Use @ file, @ folders, @ git to scope Cursor’s attention to the right parts of your codebase.

通過@file（文件）、@folders（目錄）、@git（版本庫）指令限定Cursor的代碼關注范圍

通過 @ 符號 cursor 提供了很多種限定上下文的方式，比如說文件、文件夾、git 提交記錄等等

有了限定范圍之后， cursor 生成的內容也會更加的精準

簡單來說 @ 符號來引用項目中的特定文件、文件夾或 Git 歷史記錄，cursor 會將其注意力集中在相關的上下文上，這樣就避免了 AI 在整個龐大的代碼庫中漫無目的地搜索，提高了響應速度和相關性。

第七條，擅用 .cursor目錄

Keep design docs and checklists in .cursor/ so the agent has full context on what to do next.

把設計文檔和檢查清單放在 .cursor 目錄下，這樣 agent 就能有足夠的上下文來知道下一步該做什么

這一條其實就是讓你把相關的需求文檔和設計文檔放在 .cursor 目錄下，有點類似于 Project Rules，但是 Rules 中主要是去做一些限制，而我們的需求文檔和設計文檔是告訴 cursor 應該干什么，開發(fā)什么內容，有哪些功能需要開發(fā)

這里需要注意的是，不要一次性讓 cursor 把你列的清單全部都開發(fā)完，而是要一個一個的去完成，然后一個一個的去做階段性的測試，測試完成給 cursor 反饋，然后再繼續(xù)下一個任務。

在 cursor 早期版本我們可能是通過建立一個 readme 文檔去存儲這些需求和設計文檔，然后執(zhí)行的時候去引用 readme 文檔，但是現(xiàn)在 cursor 升級版本了，你只要把相關的文檔放在 .cursor 目錄下，它每次執(zhí)行的時候就都能讀到。

這一點總結一下就是：

• 1）.cursor/ 文件夾是 Cursor 用來存儲項目特定配置和上下文信息的地方。將設計文檔、需求列表、API 規(guī)范、架構圖等重要信息放在這里，可以讓 Cursor 在工作時擁有更全面的背景知識，從而更好地理解任務的上下文和目標。
• 2） 我們可以把 .cursor/ 目錄看作是給 AI 助手的“工作臺”或“參考資料庫”。任何能幫助人類開發(fā)者理解項目的信息，同樣也能幫助 Cursor，包括需求文檔、設計規(guī)范、TODO 列表等。

第八條，AI 不行自己上

If code is wrong, just write it yourself. Cursor learns faster from edits than explanations.

如果代碼錯的太離譜，請自己寫。Cursor從代碼修改中學習的速度遠快于文字解釋。

有的時候你會發(fā)現(xiàn) cursor 改代碼，它怎么改都改不好，這個時候就需要你親自上場了，自己手動去改代碼。這樣的效率或許遠比你用文字跟 cursor 溝通怎么改來的高效。

有的代碼問題，你甚至一眼就知道問題所在，但是 cursor 就是改不好，所以與其花費大量時間嘗試用自然語言向 Cursor 解釋如何修正一段錯誤的代碼，不如直接自己動手修改。

而且 Cursor 通過分析你修改前后的代碼差異 (diff)，能更直接、更有效地學習到正確的做法。

cursor 會學習你的經驗，這是靜默的。這就是為什么說，你 cursor 用的越多，cursor 就會越懂你

案例：

比如說在 Java 開發(fā)中，我們使用 Restful 風格的 API 的時候，它其實是有四種請求方法的，GET POST PUT DELETE

但是我們國內開發(fā)的話，一般常用的就是 GET 和 POST

你用 cursor 生成 Controller 的時候，它一開始會按照標準寫法，GET POST PUT DELETE 這四種

但是如果你把 PUT 和 DELETE 都改成 POST 的時候，下一次 cursor 再生成 Controller 代碼的時候，它就會學習你的方式，入鄉(xiāng)隨俗，只生成 POST 形式

第九條，擅用聊天記錄

Use chat history to iterate on old prompts without starting over.

使用聊天記錄去迭代歷史提示詞，而不用從頭開始

Cursor 在項目級別會保留你所有的歷史對話，通過 「Show Chat History」可以查看當前項目下的所有歷史對話

我們在開發(fā)一個功能模塊的時候，去新建一個對話，這樣你的所有改動都是可以回溯的，而且 cursor 的聊天對話是可以重命名的，你完全可以把對話重命名成你對應需求模塊的名字。

因為 cursor 的聊天界面保存了所有對話歷史，所以如果一個提示詞生成的結果不完全滿意，你不需要從頭開始寫一個新的提示詞，可以在現(xiàn)有對話的基礎上進行迭代，要求 AI 改進或修改之前的輸出。

你可以說：“在剛才生成的代碼基礎上，增加一個 XX 功能” 或者 “你剛才的建議不錯，但是請把 XX 部分修改成 YY”。這樣可以節(jié)省時間，并保持上下文的連貫性。

第十條，根據需求選擇模型

Choose models intentionally. Gemini for precision, Claude for breadth.

根據需求審慎選擇模型：追求精度選用Gemini，需要廣泛覆蓋則用Claude。

也就是說我們需要了解不同模型的特性和適用場景，根據需求選擇不同的模型。一般我們寫代碼會用 Claude 和Gemini，但是在需求討論的時候可以嘗試別的模型，比如 GPT 和 DeepSeek

第十一條，提供詳細文檔

In new or unfamiliar stacks, paste in link to documentation. Make Cursor explain all errors and fixes line by line.

在接觸新或不熟悉的技術棧時，請粘貼官方文檔鏈接，并要求 Cursor 逐行解釋所有錯誤及其修復方案。

當你使用一個新的編程語言、框架或庫時，你和 Cursor 可能都對其不夠熟悉。此時，提供官方文檔的鏈接可以極大地幫助 Cursor 理解相關的 API、用法和最佳實踐。

也就是說在使用新框架或者你不熟悉的技術棧的時候，可以把相關文檔粘貼進 cursor 里面，這樣可以大大增加 cursor 的理解程度。

案例：

比如說我們現(xiàn)在使用 node.js

但是你對它又不熟悉，這個時候就可以把 node.js 的官方文檔粘貼進 cursor 里面

https://nodejs.org/docs/latest/api/

具體粘貼的位置

后續(xù)用的時候，可以手動刷新一下，讓這個文檔維持在一個最新的狀態(tài)，防止官方文檔修改了，但是你拉取了還是老版本的文檔

第十二條，構建索引

Let big projects index overnight and limit context scope to keep performance snappy.

對大型項目啟用后臺自動索引構建；限制上下文檢索范圍以確保響應迅捷。

對于一些大型項目，如果你想使用 cursor 來輔助開發(fā)的話，先索引，再動工。不要 cursor 還沒索引完，你立馬就開始開發(fā)了。

對于大型代碼庫來說，Cursor 需要一些時間來建立索引，這樣才能夠快速理解和導航代碼。如果這個索引時間相對較長，你可以讓這個索引過程在非工作時間（如夜間）進行。

同時，在日常使用中，通過 @ 符號等方式限制 Cursor 的上下文范圍，避免它在整個大型項目中搜索，從而保持其響應速度。

推薦閱讀：AI編程神器Cursor新手怎么入門? Cursor基礎使用教程

最新評論