給 AI 助理的結界術
你的 AI 助理總會像個好奇寶寶，總想翻遍你專案裡的每個角落？
連你最重要的金鑰都不放過？或者在 node_modules 這個龐大迷宮裡迷路？
這不僅浪費時間，還可能讓你的秘密外洩。今天，我們來學一招「結界術」，用 .cursorignore 幫你的 AI 助理聚焦正事，提升效能，還能保護你的專案安全！
這篇教學專為技術新手打造，簡單易懂，保證你 5 分鐘內學會怎麼設置 .cursorignore，讓 AI 乖乖聽話！
為什麼需要 .cursorignore？
.cursorignore 就像給 AI 助理畫一張地圖，告訴它「哪些地方不能去」。它的工作原理類似 .gitignore，但專為 AI 工具設計，幫你：
- 保護敏感資料：防止 AI 讀取 API Key、密碼或設定檔。
- 提升效能：避免 AI 在 node_modules 或 dist 這類大型資料夾裡浪費時間。
- 減少雜訊：讓 AI 只專注於你真正想編輯的程式碼。
閱讀提示：以下步驟簡單明瞭，搭配範例和圖片，確保你能快速上手！
步驟 1：建立 .cursorignore 檔案
- 在你的專案根目錄下，建立一個名為 .cursorignore 的檔案。
- 用任何文字編輯器（例如 VS Code）打開它。
- 開始寫入「結界規則」，告訴 AI 哪些檔案或資料夾要忽略。
截圖建議：
- 展示專案根目錄中建立 .cursorignore 檔案的畫面（檔案總管視圖）。
- 顯示用 VS Code 打開 .cursorignore 的畫面，檔案內容空白或有簡單範例。
步驟 2：寫入忽略規則
.cursorignore 的語法超簡單，每一行代表一個要忽略的檔案或資料夾。你可以用萬用字元（*）來匹配多個檔案，或直接指定資料夾。以下是幾個常見的範例：
# 忽略 node_modules 資料夾，防止 AI 陷入大型依賴迷宮
node_modules/
# 忽略打包後的檔案，這些通常不需要 AI 處理
dist/
build/
# 忽略環境設定檔，保護你的 API Key 和密碼
.env
*.env
# 忽略臨時檔案和快取
.cache/
temp/
步驟說明：
- 每行一個規則，前面加上 # 是註解，幫助你記錄規則的用途。
- 資料夾後面加 / 表示忽略整個資料夾及其內容。
- 萬用字元 * 可匹配特定類型的檔案，例如 *.log 忽略所有日誌檔案。
步驟 3：測試你的結界術
寫好 .cursorignore 後，檢查 AI 是否有乖乖遵守規則：
- 請 AI 助理分析你的專案，指令：幫我檢查.cursorignore 檔案是否存在，裡面內容是什麼？
- 觀察 AI 是否跳過了 .cursorignore 中列出的檔案或資料夾。
- 如果 AI 仍然讀取了不該讀的檔案，檢查 .cursorignore 的語法是否正確（例如確認路徑是否拼寫正確）。
常見問題與解法
- 問題：我的 .cursorignore 沒有生效
解法：確認檔案名稱是否正確（必須是 .cursorignore，不能有額外空格或副檔名）。也檢查是否將檔案放在專案根目錄。 - 問題：我不想忽略整個資料夾，只想忽略特定檔案怎麼辦？
解法：直接寫入檔案名稱或使用萬用字元，例如 secret-key.txt 或 *.key。 - 問題：我的專案有好多環境設定檔，怎麼一次忽略？
解法：用 *.env* 忽略所有以 .env 開頭的檔案，例如 .env.local、.env.production。
你的第一道結界已完成！
透過 .cursorignore，你成功為 AI 助理設下結界，保護了專案的敏感資料，還讓 AI 跑得更快、更專注！
以下是快速回顧：
- 建立檔案：在專案根目錄新增 .cursorignore。
- 寫入規則：用簡單語法指定忽略的檔案或資料夾。
- 測試效果：確保 AI 遵守規則，提升效能。
現在，試著打開你的專案，動手建立 .cursorignore 吧！
在留言區分享你的 .cursorignore 規則吧！
