Cursor Tab 補全怎麼用：接受與拒絕、跨文件跳轉、暫停（Snooze）與不出建議的排查

本文根據 Cursor 官方幫助中心《Tab completion》《How do I troubleshoot Tab completions?》整理，資料核對於 2026-10-11。

適用於誰

• 剛裝好 Cursor，發現灰色的代碼建議但不清楚有哪些操作的人；
• 搜「cursor tab not working」「cursor tab snooze」「cursor tab free plan」的人；
• 寫 Markdown、JSON 時被補全打擾，想按文件類型關掉的人。

結論先說

1. Tab 是 Cursor 的自動補全：根據你最近的修改、游標周圍的代碼和 linter 報錯給出建議，以灰色文字顯示。
2. Tab 接受整段，Esc 或繼續打字拒絕，Ctrl+→（macOS Cmd+→）逐詞接受。
3. 它不只補一行：可以一次改多行、自動補 import，接受後再按 Tab 會跳到下一處該改的位置，甚至跳到別的文件。
4. 右下角狀態欄的 Tab 指示器可以暫停（Snooze）、全局關閉、按文件擴展名關閉。
5. 付費檔（Pro / Pro Plus / Ultra）Tab 補全不限量；免費 Hobby 檔有月度額度，用完要等下個計費週期。
6. 項目規則（Rules）不影響 Tab，它只作用於 Agent。

基本操作

想換掉 Tab 這個鍵，在 Keyboard Shortcuts 設定裏搜尋 Accept Cursor Tab Suggestions 重新綁定。

三個比普通補全多出來的能力

多行修改。Tab 可以同時修改多行、補上缺失的 import，並對相關代碼給出配套的修改建議。比如你改了函數簽名，它會建議把下面幾處調用一起改掉。

文件內跳轉（jump-in-file）。接受一條建議後再按一次 Tab，它會預測你下一處要編輯的位置並把游標帶過去，省掉滾動和定位。連續按 Tab 就能把一串關聯修改走完。

跨文件建議。當一個文件的改動需要另一個文件配合時，Tab 也會預測。此時編輯器底部會出現一個「傳送門」小窗，提示可以跳到另一個文件繼續改。

用好它的關鍵是先手動改一兩處，把意圖表達出來。官方解釋，Tab 的上下文來自你最近的編輯和游標附近的代碼，新建的空文件能參考的東西很少，建議質素自然差。

暫停與關閉

點右下角狀態欄的 Tab 指示器：

• Snooze：暫停一段時間（自己選時長），適合寫註釋、寫文檔時臨時關掉；
• Disable globally：對所有文件關閉；
• Disable for specific extensions：只對某些文件類型關閉，比如 Markdown、JSON。

更細的選項在 Cursor Settings → Tab。

Tab 不出建議時怎麼查

官方給了四個原因，按順序排查：

1. 套餐額度：免費 Hobby 檔有月度 Tab 額度，用完後建議會暫停，到下個計費週期恢復。
2. 網絡不支持 HTTP/2：有些公司網絡或代理會攔 HTTP/2。打開 Cursor Settings，搜尋 HTTP Compatibility Mode，開啟後退回 HTTP/1.1，再重啟 Cursor。
3. 版本太舊：Ctrl+Shift+P（macOS Cmd+Shift+P）→ 輸入 Cursor: Attempt Update。
4. 沒有聯網：Tab 需要網絡才能工作，沒有離線模式。

如果有建議但很慢：檢查網速，停用不用的擴展；代理和加速類網絡工具會增加延遲。如果建議質素差，除了「先手動改幾處」之外，還要排查是否有別的補全類擴展在搶同一個按鍵（官方有單獨的《Extension conflicts》頁）。

常見問題

Q：Tab 和 Agent、行內編輯（Ctrl+K）有什麼區別？

Tab 是你打字時自動出現的預測，不需要寫指令；行內編輯是選中代碼後用一句話讓它改；Agent 是在側邊面板裏交代一個完整任務，它會自己讀文件、跨文件修改、跑命令。日常寫代碼三者是搭配用的。Agent 的用法見《Cursor Agent 模式怎麼用》。

Q：我寫的 Rules 為什麼對 Tab 沒用？

官方文檔明確寫了：Rules 不影響 Cursor Tab 和其他 AI 功能，只對 Agent 生效。想讓補全貼合項目風格，靠的是它從你當前文件和最近修改裏學到的上下文。

Q：Tab 補全會消耗我的模型額度嗎？

付費檔的 Tab 補全是不限量的，不從兩個用量池裏扣；免費檔按月度 Tab 額度算。詳見《Cursor 額度與套餐》。

Q：.env 這類文件會被 Tab 讀到嗎？

Cursor 預設忽略 .env、.git/ 和鎖文件；想額外排除，在項目根目錄建 .cursorignore，寫法和 .gitignore 相同。

參考資料

• Tab completion（官方幫助中心）：https://cursor.com/help/ai-features/tab
• How do I troubleshoot Tab completions?（官方幫助中心）：https://cursor.com/help/troubleshooting/tab-issues
• Keyboard Shortcuts（官方）：https://cursor.com/docs/reference/keyboard-shortcuts
• Models & Pricing（官方）：https://cursor.com/docs/models-and-pricing
• Rules（官方）：https://cursor.com/docs/rules