Git 忽略文件与常见工作流

1. .gitignore：声明不需要跟踪的文件#

.gitignore 用来声明哪些文件不应该被 Git 跟踪，例如日志、临时文件、本地环境配置、依赖目录等。

常见写法：

1
# 日志
2
*.log
3

4
# 本地环境
5
.env
6
.env.local
7

8
# 依赖目录
9
node_modules/
10

11
# 构建产物
12
dist/
13
build/

.gitignore 更适合放团队共同认可的忽略规则，例如构建产物、依赖目录、日志文件。

2. 已经被跟踪的文件不会自动被忽略#

如果文件已经被 Git 跟踪，后来再加入 .gitignore 不会自动停止跟踪。需要先从 Git 索引中移除：

1
git rm --cached <file>

如果要按 .gitignore 重新整理整个仓库索引：

1
git rm -r --cached .
2
git add .
3
git commit -m "remove ignored files from tracking"

这类操作影响范围较大，提交前一定要检查：

1
git status -sb
2
git diff --cached

3. 本地个人忽略规则#

有些文件只是不想在自己机器上看到，不一定适合写进项目 .gitignore。这类规则可以放到：

1
.git/info/exclude

它和 .gitignore 类似，但不会提交到仓库，因此不会影响其他人。

1. 第一次提交一个新项目#

1
git init
2
git add .
3
git commit -m "initial commit"
4
git remote add origin <remote-url>
5
git push -u origin main

如果当前默认分支叫 master，可以根据团队规范决定是否改成 main。

2. 日常开发一个功能#

1
git switch main
2
git pull
3
git switch -c feature/login
4

5
# 修改代码
6

7
git status
8
git diff
9
git add .
10
git diff --cached
11
git commit -m "add login form"
12
git push -u origin feature/login

这个流程里有两个检查点：

• git diff：暂存前看工作区具体改动。
• git diff --cached：提交前看暂存区内容。

3. 拉取远程更新前先检查#

1
git status
2
git fetch origin
3
git log --oneline --graph --decorate --all
4
git pull origin main

如果本地工作区还有未提交变更，先提交、stash，或者明确丢弃后再拉取，避免混在一起难排查。

4. 清理误提交的环境文件#

假设 .env 已经被提交过，现在想停止跟踪：

1
echo ".env" >> .gitignore
2
git rm --cached .env
3
git add .gitignore
4
git commit -m "stop tracking local env file"

如果 .env 里已经包含真实密钥，还需要额外处理密钥泄露问题：撤销跟踪不等于从历史中彻底删除秘密。

1. 误以为 .gitignore 会影响已经提交的文件#

.gitignore 只影响“未被跟踪的新文件”。已经进入 Git 历史或索引的文件，需要用 git rm --cached 移除跟踪。

2. 把本地个人规则提交给所有人#

只和个人编辑器、个人临时文件有关的忽略规则，不一定要写进项目 .gitignore。可以考虑 .git/info/exclude。

3. 提交前不看暂存区#

日常工作流里最容易漏掉的是 git diff --cached。它能帮你确认下一次提交到底包含什么。

4. 密钥误提交后只改 .gitignore#

如果密钥已经进了 Git 历史，只加入 .gitignore 并不能让历史里的密钥消失。正确处理通常还包括吊销旧密钥、替换新密钥，并按团队流程处理历史清理。