如何修復Gitignore無法執行的問題

Gitignore 是 Git 中用於從版本控制中排除檔案和目錄的強大工具。它能防止不必要的檔案被跟蹤，從而保持版本庫的整潔和有序。

不過，在某些情況下，Gitignore 可能無法按預期工作，導致檔案仍被跟蹤或被忽略的檔案未被排除。

在本文中，我們將深入瞭解 Gitignore 的基礎知識、排查 Gitignore 問題、探索 Gitignore 高階技術並解決不同場景下的 Gitignore 問題。

瞭解 Gitignore 基礎知識

Gitignore 是一個配置檔案，包含一系列模式，指定 Git 應忽略的檔案或目錄。

它採用的語法包括萬用字元 (*)、否定 (/) 和註釋 (#)。Gitignore 檔案可以是本地、全域性或倉庫級的，取決於它們在專案中的位置。

要建立 Gitignore 檔案，請在 Git 倉庫的根目錄下建立一個名為 .gitignore 的純文字檔案。

然後使用 Gitignore 模式指定要忽略的檔案或目錄。例如，要忽略所有 .log 檔案和名為 node_modules 的目錄，可以建立一個內容如下的 Gitignore 檔案：

*.log
node_modules/

這將阻止 Git 追蹤任何帶有 .log 副檔名和 node_modules 目錄的檔案。

修復 Gitignore 問題的 4 個故障排除技巧

有幾種常見情況會導致 Gitignore 無法按預期執行。讓我們來探討其中一些，並學習如何修復。

1. 檔案在新增到 Gitignore 之前已被跟蹤或提交

有時，你可能會在檔案已被跟蹤或提交後才將其新增到 Gitignore。在這種情況下，即使 Gitignore 中列出了這些檔案，Git 也會繼續跟蹤它們。

要取消跟蹤或刪除已被跟蹤的檔案，可以分別使用以下命令：

# Untrack files
git rm --cached <file>
# Remove files
git rm <file>

例如，如果要解除對名為 “config.ini” 的檔案的跟蹤，可以執行以下命令：

git rm --cached config.ini

這將從 Git 快取中移除該檔案，防止將來被跟蹤。

2. 更新 Git 快取以反映 Gitignore 中的改動

修改 Gitignore 檔案後，需要更新 Git 快取以反映這些修改。這可以使用 “git add” 命令來完成。

例如，如果在 Gitignore 中新增了忽略 .log 檔案的新模式，就可以用下面的命令更新 Git 快取：

git add .gitignore

3. Gitignore 模式中的大小寫敏感性問題

Gitignore 模式預設區分大小寫，這意味著 File.txt 和 file.txt 將被視為兩個不同的檔案。但有些作業系統（如 Windows 和 macOS）的檔案系統不區分大小寫，這會導致 Gitignore 出現問題。

要解決 Gitignore 模式中的大小寫敏感性問題，可以使用 git config 命令將 core.ignorecase 配置選項設定為 false，在終端執行以下命令：

git config core.ignorecase false

這將使 Gitignore 模式對專案的大小寫敏感，確保字母大小寫不同的檔案被視為不同的檔案。

4. 巢狀的 Gitignore 檔案

如果在版本庫的不同目錄下有巢狀的 Gitignore 檔案，Git 可能無法正確理解模式，導致 Gitignore 無法正常工作。

要解決這個問題，你可以在 Gitignore 模式中使用 ！（感嘆號）字元來指定例外情況。

例如，如果你在名為 docs 的目錄下有一個巢狀的 Gitignore 檔案，而你又想排除一個名為 important.docx 的檔案被忽略，你可以在父 Gitignore 檔案中新增以下模式：

docs/*
!docs/important.docx

這將確保 important.docx 檔案不會被忽略，即使 docs 目錄已被忽略。

使用 Gitignore 模板： 設定全域性 Gitignore 檔案

相信你現在已經修正了 Gitigoner 的錯誤。最後，讓我們來探討一下如何為所有 Git 專案建立一個全域性 Gitignore 檔案。

在多個 Git 倉庫中工作時，為每個倉庫維護一個獨立的 Gitignore 檔案會變得很乏味。幸運的是，Git 提供了一種設定全域性 Gitignore 檔案的方法，該檔案可用於所有 Git 倉庫。

設定全域性 Gitignore 檔案的步驟如下：

1. 建立全域性 Gitignore 檔案

第一步是在系統中建立全域性 Gitignore 檔案。可以使用記事本或 Vim 等文字編輯器建立檔案。

也可以使用命令列建立檔案，執行下面的命令：

touch ~/.gitignore_global

這將在電腦的主目錄下建立一個名為 .gitignore_global 的空檔案。

2. 在全域性 Gitignore 檔案中新增模式

建立全域性 Gitignore 檔案後，就可以使用與普通 Gitignore 檔案相同的語法新增模式了。

例如，要忽略副檔名為 .html 的所有檔案，可以在檔案中新增以下一行：

*.html

您可以在檔案中新增任意多個模式（每行一個模式）。

3. 設定 Git 使用全域性 Gitignore 檔案

最後一步是告訴 Git 使用全域性 Gitignore 檔案。執行以下命令即可：

git config --global core.excludesfile ~/.gitignore_global

這條命令會告訴 Git 使用 ~/.gitignore_global 作為全域性 Gitignore 檔案。你只需執行一次這條命令，Git 就會記住你在系統中所有倉庫的配置。

有了全域性 Gitignore 檔案，你就可以在其中新增將在所有版本庫中被忽略的模式了。這樣可以省去為每個版本庫維護獨立 Gitignore 檔案的大量時間和精力。

小結

Gitignore 是一個強大的工具，用於控制 Git 倉庫中哪些檔案和目錄會被忽略。不過，瞭解它的行為和侷限性對避免出現忽略檔案或意外行為非常重要。

瞭解 Gitignore 的工作原理並遵循最佳實踐，就能有效管理 Git 倉庫中被忽略的檔案，改善開發工作流程。

現在輪到你了： 您遇到過這個問題嗎？你是如何解決的？您還使用過本文未涉及的其他方法嗎？請在評論中告訴我們！