建立 2024-01-01 更新 2026-09-15

.gitignore

.gitignore 告訴 Git 不要追蹤哪些檔案。密鑰、依賴套件、編譯產物、編輯器暫存不該進儲存庫，否則會把專案撑得很髒，還可能把密碼推上 GitHub。

建立檔案

在專案根目錄：

touch .gitignore

GitHub 新建儲存庫時也可勾選 gitignore 範本。常見語言範本見 github/gitignore。

寫法範例

# 忽略所有 .log 檔案
*.log

# 忽略 node_modules 資料夾
node_modules/

# 忽略特定檔案
secret.txt

# 忽略環境變數
.env

# 忽略編譯產物
/dist

通配符：* 任意多字元、? 單一字元、**/ 任意層子目錄。

語言範例

Python：

__pycache__/
*.pyc
*.pyo
.env
.venv/

Node.js：

node_modules/
.env
dist/

已經被追蹤的檔案

.gitignore 只對尚未追蹤的檔有效。若檔案早就 commit 過，要先從版控移除、但保留本機檔案：

git rm --cached <檔案名稱>

然後再 commit 這次「停止追蹤」的變更。已推上 GitHub 的密鑰必須視為外洩，應改密鑰而不是只靠 gitignore。