Cursor 完整教學 2026：從新手到 production-grade 的 AI Coding 工作流

如果你 2024 年 Q4 後還在純用 VS Code 寫程式，你大概已經感受到團隊裡用 Cursor 的同事「怎麼比我快這麼多」。Cursor 不只是 VS Code + Copilot 升級版，它的 Composer、Tab、Agent 三個模式讓 AI 從「補全工具」進化到「副駕駛」，改變的不是速度，是工作流本身。

這篇文章從零教起，涵蓋你需要知道的所有實戰技巧。

—

Cursor 是什麼？跟 GitHub Copilot 差在哪

核心定位差異

• GitHub Copilot:VS Code 的 AI 補全外掛，定位是「AI 鍵盤」
• Cursor:基於 VS Code fork 的獨立 IDE,定位是「AI-first IDE」

三大功能對比

功能	GitHub Copilot	Cursor
程式碼補全	✓	✓（Tab 智慧度更高）
Chat 對話	✓（側邊欄）	✓（更深整合 codebase）
Composer 多檔案編輯	部分（Workspace)	✓ 核心功能
Agent 模式自主執行	部分（Copilot Workspace)	✓ 強項
MCP 支援	×	✓
Codebase Q&A	部分	✓ 預設啟用
模型選擇	GPT-4o（預設）	Claude / GPT / o1 / 自家 cursor-small

—

安裝與初始設定

下載與帳號

1. 到 cursor.com 下載 macOS / Windows / Linux 版本
2. 用 Google / GitHub 帳號登入
3. Pro 訂閱 $20/月:無限 Cursor Tab + 500 次 fast premium request + 無限 slow request

第一次開啟必做設定

1. 匯入 VS Code 設定:Cursor 開啟時會自動偵測，一鍵匯入主題、外掛、快捷鍵
2. 設定預設模型:Cmd/Ctrl + , → Models → 選擇主要模型（推薦 Claude 4.7 Sonnet 或 GPT-5）
3. 啟用 Privacy Mode（Pro 用戶）:設定 → Privacy → 開啟，你的程式碼不會被用於訓練
4. 語言設定中文:Composer 與 Chat 預設可用中文，免額外設定

—

三大核心模式：Tab、Chat、Composer

1. Cursor Tab（智慧補全）

按 Tab 接受建議，Cursor 會「多行多區段」一次補完。範例：

# 原檔案有
def calculate_total(items):
    pass

# 你打了
def calculate_total(items):
    return |

Cursor 會自動補完（sum(item.price * item.qty for item in items))+ 同時建議補上 type hints + docstring,按 Tab 全部一次接受。

進階技巧:當前位置補完不準時，按 Tab 後再按 Tab 會「跳到下一個建議位置」連續編輯。

2. Chat(Cmd/Ctrl + L)

側邊欄對話框，適合「問問題」或「單檔小修改」。

Chat 進階用法:

• @文件名:把指定檔案塞進 context
• @web:讓 Cursor 上網查資料（Bing 搜尋）
• @docs:加入官方 docs（React、Next.js、Tailwind 等）
• @codebase:讓 Cursor 自己決定哪些檔案要進 context（語意搜尋）
• @git:加入 git diff / commit message
• @past chats:回顧歷史對話

3. Composer(Cmd/Ctrl + I)

這是 Cursor 的殺手級功能——多檔案同時編輯。

典型流程:

1. 開啟 Composer 視窗
2. 用自然語言描述需求：「把所有 .astro 元件的 onClick 改成 handleClick」
3. Cursor 列出將修改的檔案
4. 按 Accept All 一次套用，或逐檔審核

Agent 模式（Composer 升級版）:

• 自動執行 terminal 指令（npm install / 執行測試）
• 看錯誤訊息自動修
• 重複迭代直到成功

—

cursorrules:你的專案專用 AI 行為規範

為什麼需要 .cursorrules?

預設 Cursor 不知道你的專案規範。寫 .cursorrules 檔案放在專案根目錄，所有 AI 互動都會載入這份規則。

範例 .cursorrules

You are an expert TypeScript and React developer.

Code style:
- Use functional components with hooks, no class components
- Prefer arrow functions
- Use named exports, avoid default exports
- Always add TypeScript types, never use `any`

Project conventions:
- API routes live in src/app/api/
- React components in src/components/
- Utilities in src/lib/
- Use TanStack Query for data fetching, no direct fetch()

Testing:
- Use Vitest, not Jest
- Test files end with .test.ts(x)
- Mock external APIs with msw

Output:
- Always show full file content when editing, not partial diffs
- Don't add comments unless logic is non-obvious
- Match existing import order: external > internal > relative

進階：.cursor/rules 多檔規則

Cursor 0.40 後支援 .cursor/rules/*.mdc 多檔規則，可依檔案類型啟用不同規範：

# .cursor/rules/api.mdc
---
description: API route conventions
globs: src/app/api/**/*.ts
---

All API routes must:
1. Use Zod for input validation
2. Return NextResponse.json() not raw Response
3. Handle errors with try/catch + return 500 with safe message

—

模型選擇策略：每種任務該用哪個模型？

2026 年 Cursor 可用模型

• claude-opus-4-7:複雜推理、架構設計、難 bug
• claude-sonnet-4-6:日常 coding、平衡選擇（推薦預設）
• claude-haiku-4-5:快速問答、簡單修改
• gpt-5:文件撰寫、需要創意的程式碼
• gpt-5-codex:程式碼補全（優化過快與精準）
• o3-pro:數學、演算法、複雜邏輯推導
• cursor-small:Cursor 自家模型，Tab 補全用，無使用次數限制

任務對應建議

任務	推薦模型
一般開發、refactoring	claude-sonnet-4-6
複雜系統設計	claude-opus-4-7
演算法 / 數學	o3-pro
文件 / 註解撰寫	gpt-5
程式碼補全（Tab)	cursor-small（免費）
寫 unit test	claude-sonnet-4-6
Code review / 找 bug	claude-opus-4-7

—

MCP 整合：讓 Cursor 接上你的工具鏈

Cursor 0.43+ 原生支援 MCP (Model Context Protocol）。設定路徑：Settings → Features → MCP → Add new MCP server。

範例：接 GitHub MCP server

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
      }
    }
  }
}

接好後在 Composer 可直接問「幫我看 PR #45 的 review comments 並逐條修正」，Cursor 會用 MCP 自動拉 PR 內容。

詳見 Claude MCP 完整教學 2026。

—

Production-grade 工作流範例

範例 1：從 GitHub Issue 到 PR 全程 AI 協作

1. Composer:@web 拉 Issue 連結 → 讀懂需求
2. Composer Agent 模式:依需求修改多檔 → 跑測試 → 自動 fix 錯誤
3. Chat:@git 看 diff → 寫 commit message
4. Composer:寫 PR description（用 .cursorrules 指定格式）
5. MCP github:自動建 PR,加 reviewer

範例 2:Code Review 自動化

1. 建立 .cursorrules:加入「Review checklist」段落
2. Chat:@git 看 unstaged diff,問「用 checklist 審這份 diff」
3. Cursor 列出 issues + 修改建議
4. 你決定 accept / reject

範例 3:Refactoring 大型專案

1. Composer:選 50+ 檔案，描述目標（「把所有 useState 改成 zustand」）
2. 預覽變更:Cursor 列出所有將修改的檔案
3. 逐檔 review:有疑問處 reject 並補 prompt
4. 完成後跑 test:Composer Agent 自動執行 + 修錯

—

團隊使用的 5 個安全與成本管控建議

1. 啟用 Privacy Mode

Pro 用戶務必開啟。沒開的話，你的程式碼可能進入訓練資料。

2. 用 Business 方案

$40/user/月，提供：

• SSO / SCIM
• 集中帳單
• 用量管理 dashboard
• 強制 Privacy Mode
• 外部 logs 整合（Datadog / Splunk)

3. .cursorrules 納入 git

讓全團隊共用同一份 AI 行為規範，新人入職第一天就有一致基準。

4. 機敏專案禁用 @web

.cursor/settings.json 可禁用網路存取，避免 prompt injection 透過外部資料注入。

5. Code Review 不能省

AI 寫的程式仍需人類審核。特別注意:依賴新增、外部 API call、SQL/shell 注入點、權限檢查。

—

常見問題（FAQ)

Q1:Cursor 跟 GitHub Copilot 哪個好？

Cursor 的 Composer 多檔編輯與 Agent 模式遠勝 Copilot,但 Copilot 在大企業整合（GitHub Enterprise / Azure）成熟度更高。個人 / 小團隊用 Cursor、大企業有 GitHub 合約用 Copilot 已夠用。

Q2:Cursor 月費 $20 划算嗎？

每天 coding > 1 小時的開發者，Cursor 帶來的時間節省遠超 $20。主要受益場景:寫測試、refactor、寫 boilerplate、看陌生 codebase。

Q3:Cursor 可以離線使用嗎？

不行。Cursor 的 AI 功能依賴雲端模型 API。離線時純編輯功能（VS Code 部分）仍可用。

Q4:Cursor 寫的程式碼安全嗎？

模型生成的程式碼仍需 code review,特別注意：依賴注入、SQL 注入、XSS、CSRF、權限檢查。Cursor 的程式碼品質明顯優於 2023 年 Copilot,但不能無條件信任。

Q5：中文 prompt 效果如何？

完全可用。主流模型（Claude / GPT-5）中文理解與英文相當。中文 prompt 寫程式技術詞混雜也沒問題。

Q6:Cursor 會吃很多 RAM 嗎？

VS Code 基底 + Electron,至少需要 8GB RAM,推薦 16GB 以上。大型專案 + 多視窗開啟可達 4–8GB。MacBook M 系列效率較佳。

Q7：可以用 Cursor 寫前端設計稿嗎？

可以。搭配 v0.dev / Vercel AI SDK / Bolt.new 工具鏈。Cursor 適合「寫程式 + 修細節」，設計稿產生用 v0.dev 起手較快。

Q8:Cursor 跟 Cline / Continue 差在哪？

• Cursor:獨立 IDE、付費、產品力最強、最穩定
• Cline （前 Claude Dev）:VS Code 外掛、開源、自帶 API key,適合喜歡 VS Code 不想換的人
• Continue:VS Code 外掛、開源、可自架本地模型（Ollama),適合資安敏感企業

—

延伸閱讀

• Claude MCP 完整教學 2026 — 把 Cursor 接上你的工具鏈
• 2026 AI Code Review 工具比較 — Cursor 之外的 PR 審核 AI
• VS Code 外掛精選 2026 — Cursor 也能用的 VS Code 外掛