gitignore

將專案提交至版本庫並忽略不需要追蹤的檔案

在 Git 專案中，一般情況下會將大部分檔案納入版本庫管理，但有一些檔案並不需要被追蹤（例如臨時檔案、編譯過程中生成的檔案等）。這些檔案可以通過設置忽略規則，避免出現在未追蹤的檔案清單中，保持清單整潔。

使用 .gitignore 忽略不需要追蹤的檔案

1. 建立 .gitignore 文件：
   • 在專案的根目錄建立一個名為 .gitignore 的文件，用來定義要忽略的檔案和目錄。
2. 設定忽略規則：
   • 在 .gitignore 文件中，按照以下格式列出不需要追蹤的檔案或目錄。例如，若只需要提交 HelloWorld.txt，則可以忽略其他檔案：
     # 忽略所有檔案
*# 排除 HelloWorld.txt，讓 Git 追蹤它
     !HelloWorld.txt
3. 檢查忽略效果：
   • 使用 git status 查看專案狀態，確認 .gitignore 文件中的規則已生效。所有符合忽略條件的檔案將不會顯示在未追蹤清單中。
4. 提交專案至版本庫：
   • 將 HelloWorld.txt 加入暫存區並提交：
     git add HelloWorld.txt
git commit -m "新增 HelloWorld.txt"

.gitignore 文件格式說明

• 通配符 *：匹配所有檔案。
• ! 排除規則：使用 ! 來排除特定檔案，使其被 Git 追蹤。
• 忽略特定檔案或目錄：直接寫入檔名或目錄名稱即可。

.gitignore 文件格式規則

在 Git 中，.gitignore 是一個特殊文件，用於設定專案中不需要被 Git 追蹤的檔案和目錄。該文件名稱固定為 .gitignore，不可更改。

基本規則

1. 註釋行：# 開頭的行表示註釋，不會影響忽略規則的設定。
   # 這是一行註釋

2. 避免遞迴匹配：/ 開頭的規則表示只匹配當前目錄，避免遞迴匹配。
   /temp.txt # 只忽略當前目錄的 temp.txt，不影響子目錄中的 temp.txt

3. 忽略目錄：/ 結尾表示忽略目錄。
   logs/ # 忽略 logs 目錄及其所有內容

4. 取反規則：! 開頭表示取反，即不忽略符合該模式的檔案或目錄。
   !important.txt # 除忽略的規則外，還原重要文件 important.txt 的追蹤


支援的 glob 模式

glob 是一種簡化的匹配模式，可以用來匹配文件和目錄的名稱：

• *：匹配零個或多個任意字符
  *.log # 匹配所有以 .log 結尾的文件

• [abc]：匹配括號中列出的任意字符
  file[123].txt # 匹配 file1.txt、file2.txt、file3.txt

• ?：匹配任意一個字符
  file?.txt # 匹配 file1.txt、file2.txt 等單個字符文件名

• [0-9]：匹配指定範圍內的數字
  file[0-9].txt # 匹配 file0.txt 到 file9.txt

• **：匹配任意層級的目錄
  a/**/z # 匹配 a/z、a/b/z、a/b/c/d/z 等所有中間目錄的文件


.gitignore 文件範例