什麼是 .gitignore
.gitignore 是 Git 的設定檔,用於指定哪些檔案和目錄應該被版本控制系統忽略。它使用模式比對來排除建置產物、依賴套件、暫存檔案、敏感資料等不應被追蹤的檔案。檔案中每一行代表一個忽略模式,支援萬用字元(*)、目錄分隔符(/)和否定(!)運算子。
Preparing your comprehensive developer toolkit
實用指南
快速產生.gitignore檔案,支援多種程式語言和框架模板
.gitignore 檔案是一個文字檔案,告訴 Git 在專案中忽略哪些檔案或目錄。它防止不必要的檔案(如建置輸出、相依性資料夾 node_modules、IDE 設定、暫存檔案和敏感資料)被版本控制追蹤。該檔案使用模式比對來指定排除規則,保持倉庫整潔並防止意外提交不應共享或版本化的檔案。
.gitignore 是 Git 的設定檔,用於指定哪些檔案和目錄應該被版本控制系統忽略。它使用模式比對來排除建置產物、依賴套件、暫存檔案、敏感資料等不應被追蹤的檔案。檔案中每一行代表一個忽略模式,支援萬用字元(*)、目錄分隔符(/)和否定(!)運算子。
Git 使用 glob 模式進行檔案比對。星號(*)比對除斜線外的任意字元,雙星號(**)遞迴比對任意目錄,問號(?)比對單一字元,方括號([])比對字元集。以斜線(/)結尾的模式只比對目錄,以斜線開頭的模式從儲存庫根目錄比對,驚嘆號(!)否定模式。
始終忽略建置輸出(dist/、建置/)、依賴套件(node_modules/、vendor/)、IDE檔案(.vscode/、.idea/)、系統檔案(.DS_Store、Thumbs.db)、環境檔案(.env)和日誌檔案(*.log)。使用具體模式而非寬泛萬用字元,避免意外忽略重要檔案。在專案早期提交.gitignore檔案。
正確設定的.gitignore可減小儲存庫大小,加快Git操作速度,防止提交大型二進位檔案或產生程式碼。它能提高複製效能,降低儲存成本,保持儲存庫專注於原始程式碼。將最具體的模式放在前面以獲得更好的比對效能。
內建50+種常用範本,涵蓋節點.js、Python、Java、React、Vue、.NET等主流技術棧
多選範本自動合併去重,智慧組合語言、框架和編輯器規則,避免衝突
支援新增專案特定的忽略模式,靈活配置以滿足個人化需求
一鍵複製到剪貼簿或下載為.gitignore檔案,立即套用到專案中
.gitignore 檔案告诉 Git 在追蹤儲存庫更改时忽略哪些檔案和目录。它可以防止意外提交建構产物、依賴项、臨時檔案、敏感資料、IDE 設定和操作系统特定檔案。这可以保持儲存庫整洁、减小儲存庫大小、提高 Git 性能,并保护敏感信息不被版本化。
您可以选择多个範本(例如 節點.js + React + VS Code),生成器会自動合并它们,删除重复的模式。範本会智能组合:语言範本提供基础規則,框架範本添加框架特定的忽略项,编辑器範本添加 IDE 特定的檔案。最终的 .gitignore 包含您所选範本的所有唯一模式。
可以,您可以在自訂規則部分添加自訂忽略模式。每行輸入一个模式,使用与 .gitignore 檔案相同的 glob 模式语法。範例包括:*.log(忽略所有日志檔案)、node_modules/(忽略 node_modules 目录)、.env(忽略环境檔案)或 dist/(忽略建構输出)。自訂模式会附加到生成的範本内容中。
应包含的常见模式:建構输出(dist/、建置/、target/)、依賴项(node_modules/、vendor/、.venv/)、IDE 檔案(.vscode/、.idea/、*.swp)、操作系统檔案(.DS_Store、Thumbs.db)、环境檔案(.env、.env.本機)、日志(*.log、日誌/)和臨時檔案(*.tmp、*.cache)。生成器的範本包含您所选技术栈的这些常见模式。
生成 .gitignore 后,您可以将内容复制到剪贴板并粘贴到專案根目录的新 .gitignore 檔案中,或直接下载。如果您已有 .gitignore 檔案,可以手动合并模式。添加檔案后,Git 会自動忽略指定的檔案。注意:.gitignore 只影响未追蹤的檔案;要忽略已追蹤的檔案,您需要先从 Git 索引中删除它们。
Git 官方文件,詳細說明 .gitignore 檔案格式和模式比對規則
GitHub 官方 gitignore 範本儲存庫,涵蓋100+種語言和工具
全面的 .gitignore 模式和最佳實踐教學
為作業系統、IDE和程式語言建立 .gitignore 檔案的Web服務
Pro Git 書籍章節,解釋檔案忽略機制和進階用法
返回工具頁面,立即使用相關功能。