# .gitignore

*更新於 2026.07.14 · 約 1 分鐘閱讀*

---

.gitignore 是放在專案資料夾裡的一個純文字檔，內容是一份「不要納入版本控制的清單」。程式開發常用 Git 這套工具來記錄每一次修改，而寫進 .gitignore 的檔案，Git 就會當作沒看到——不記錄、不追蹤，之後上傳到 GitHub 之類的平台時也不會被帶上去。最常見的用法，就是把存放密碼與 [API 金鑰](/glossary/api-key/)的 .env 檔案排除在外。

如果你是用 AI 寫程式而不確定該寫什麼進去，可以直接請 AI 幫忙：「請幫我建立 .gitignore，把這個專案裡含有金鑰或密碼的檔案排除掉。」AI 對這件事相當在行，你不需要自己判斷。這也是不懂程式的人保護自己最省力的一個動作。

不過有兩個重要的限制必須知道。第一，.gitignore **只對「還沒被記錄過」的檔案有效**。如果你已經把 .env 提交進 Git 歷史裡，事後才把它加進 .gitignore，它仍然留在歷史紀錄中，任何拿到這個倉庫的人都翻得出來——這種情況下，唯一可靠的補救是[輪替金鑰](#)，而不是清理檔案。第二，.gitignore 管的是 Git，**它管不了別的程式**。任何能讀取你資料夾的軟體——包括 AI 程式助理、雲端同步、備份工具——都可能讀到甚至上傳被 .gitignore 排除的檔案。它是一道有用的防線，但不是一道牆。真正敏感的東西，最好根本不要放在工作資料夾裡。

---

來源：[.gitignore](https://ethome.cc/glossary/gitignore/)
ethome.cc — 生活化的資安科普