2-5 如何在 Cursor 中提供脈絡 (上下文) @File 、 @Code 、 @Git 介紹

在這個單元中，我們會談如何在 Cursor 中提供脈絡 (上下文)，以幫助 AI 模型或 AI 代理更準確地理解我們的需求，並給出符合預期的回答或改動。

Cursor 提供了一些非常實用的快捷鍵，這些快捷鍵以小老鼠符號 @開頭，可以看作是一種索引。透過這些索引，我們能將相關脈絡導入 Cursor，讓 AI 更清楚我們解決問題時需要關注的細節。

Cursor 中常用的快捷鍵

• @file：引用整個檔案作為上下文。
• @code：引用特定程式碼段落（避免過多無關內容）。
• @git：引用 Git 記錄（如 commit、PR diff），方便 Code Review。
• @docs：引用技術文件（如 Next.js 官方文件），避免模型使用過時資訊。
• @web：讓 Cursor 先進行網路搜尋，再根據最新內容回答（適用於無官方文件的新技術）。

@file 引用文件作為脈絡

假設想引用一個名為 memorize 的檔案，我可以點擊 @file，選擇該檔案後，Cursor 會將其加入對話框作為脈絡。或者可以直接在對話框輸入 @ 符號，然後從出現的選單中選擇 memorize 檔案。

加入脈絡後，我可以輸入：「請幫我為 @memorize 檔案中的函式寫測試。」送出後，Cursor 會根據這個脈絡生成相關測試程式碼。

@code 引用特定程式碼片段

除了引用整個檔案外，我們也能引用特定程式碼片段。使用 @code 快捷鍵，輸入關鍵字，即可找到並引用 memorize 函式。與引用整個檔案不同的是，這種方式只會顯示特定函式的程式碼。如果檔案較大，且包含許多你暫時不關心的細節，建議使用 @code 而非 @file，這樣能讓脈絡更精準。

@git 引用 Git 紀錄

我們也能將 Git 紀錄作為脈絡。例如，使用 @git 快捷鍵，可以看到特定 commit 的紀錄。

假設想請 Cursor 針對某個 commit 進行程式碼審查 (Code Review)，可以引用該 commit，然後輸入：「請評論這段程式碼，告訴我哪裡可以改進。」送出後，Cursor 會根據該 commit 內容提供建議。這在提交 PR 前，想讓 Cursor 幫忙自己看程式碼時會特別有用。

@docs 引用技術文件

使用 @doc 快捷鍵，可以引用內建或自訂的文件。例如，假設有個關於 Next.js 的問題，我可以引用 Next.js 文件，然後問：「在 Next.js 使用 App Router 的情況下，如何新增一個路由？」。

將最新技術文件作為脈絡的好處在於，AI 模型的訓練數據有截止時間，若技術框架在截止後更新，AI 可能給出過時答案。透過引用最新文件，就能確保回答符合當前版本，避免 AI 的幻覺問題 (hallucination)。

如果問題涉及沒有官方文件的最新技術，可以使用 @web 快捷鍵。Cursor 會先搜尋網路，根據最新內容回答。這能有效避免過時或不準確的回覆。

提升回答品質的小技巧

除了上述快捷鍵，還有一個值得推薦的做法：在與 Cursor 對話或與 AI 代理互動時，可以在提示詞最後加上：「如果需要更多資訊，請讓我知道。」這句話來自 X (推特) 上一個熱門貼文，作者發現加上這句後，Cursor 會主動提問，讓你補充更多脈絡，進而提升回覆品質或改動結果。

舉例來說，若擔心提供的脈絡不足，可以在提示詞後加這句話；當 Cursor 提出問題時，再補充資訊給 Cursor，這樣往往能得到更準確的輸出。

此系列文章為 《給工程師的 Cursor 工作流 — 透過 AI 代理全方位提升開發生產力》 搭配的教材。希望透過這系列文章，將過去協助導入 AI 工具及使用 Cursor 的經驗擴展並分享給想提升生產力的讀者。如果對課程感興趣的讀者，可以加入 E+ 成長計畫，觀看影片學習。