1
2
3
4
5
6
7
8
9

# 提交前，先看看会提交什么
git status

# 检查是否有不该提交的文件
git diff --name-only --cached

# 如果发现了不该提交的文件...
git rm --cached 不该提交的文件
echo "不该提交的文件" >> .gitignore

1
2
3
4
5
6
7
8

# 一个普通的 React 项目
ls -lh node_modules | wc -l
# 输出：3000+ 个文件

du -sh node_modules
# 输出：200M

# 而 package.json 只有 2KB

1
2
3
4

# 有些包会创建深层嵌套的目录
node_modules/a/node_modules/b/node_modules/c/...

# Windows 下路径过长会导致问题

1
2
3

# 有些包包含平台特定的二进制文件
# macOS 的不能在 Windows 上运行
# 提交上去也没用

1
2
3
4

# 只要有 package.json，随时可以重建
npm install
# 或者
yarn install

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 1. 创建 .gitignore
echo "node_modules/" >> .gitignore

# 2. 从 Git 中移除（如果已经提交了）
git rm -r --cached node_modules

# 3. 提交 .gitignore
git add .gitignore
git commit -m "chore: 忽略 node_modules"

# 4. 提交 package.json（必须！）
git add package.json package-lock.json
git commit -m "chore: 添加依赖配置"

1
2
3
4
5
6
7

# 方法1：使用 npm 的 bundledDependencies
# 在 package.json 中配置

# 方法2：提交特定目录，忽略其他
# .gitignore 内容：
node_modules/*
!node_modules/some-special-package/

1
2
3
4

# .env.example - 提交这个
DATABASE_URL=postgresql://user:password@localhost:5432/mydb
API_KEY=your_api_key_here
SECRET_KEY=your_secret_key_here

1
2
3
4

# .env - 不提交这个
DATABASE_URL=postgresql://admin:real_password@prod-db:5432/mydb
API_KEY=sk_live_1234567890abcdef
SECRET_KEY=super_secret_key_12345

1
2
3
4

# .gitignore
.env
.env.local
.env.*.local

1
2
3

# 新成员加入时
cp .env.example .env
# 然后手动填入真实值

1
2
3
4
5
6
7

# 1. 立即撤销提交（如果还没 push）
git reset --soft HEAD~1
git rm --cached .env
git commit -m "fix: 移除敏感信息"

# 2. 如果已经 push，需要更复杂的操作
# 见 8.9 节：敏感信息泄露后的紧急处理

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# macOS
brew install git-lfs

# Ubuntu/Debian
sudo apt-get install git-lfs

# Windows
# 下载安装包：https://git-lfs.github.com/

# 初始化
git lfs install

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 追踪所有 .psd 文件
git lfs track "*.psd"

# 追踪特定目录
git lfs track "assets/images/*"

# 追踪特定文件
git lfs track "design/mockup.sketch"

# 查看追踪规则
git lfs track

1
2
3
4
5
6

# 正常使用 git add/commit/push
git add design.psd
git commit -m "add: 添加设计稿"
git push origin main

# 大文件会被自动上传到 LFS 服务器

1
2
3
4
5

# 如果仓库已经有大文件，需要迁移
git lfs migrate import --include="*.psd,*.zip"

# 这会重写历史，需要 force push
git push --force origin main

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# 注释以 # 开头
# 这是注释

# 忽略特定文件
secret.txt

# 忽略特定目录
node_modules/

# 使用通配符
*.log          # 忽略所有 .log 文件
*.tmp          # 忽略所有 .tmp 文件

# 忽略特定类型的文件
build/         # 忽略 build 目录（包括子目录中的）
/build         # 只忽略根目录的 build 目录

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# 忽略所有 .txt 文件，但不忽略 readme.txt
*.txt
!readme.txt

# 忽略所有 .log 文件，但不忽略 keep/ 目录下的
*.log
!keep/*.log

# 忽略所有 .log 文件，但不忽略 keep/ 及其子目录下的
*.log
!keep/

# 忽略 build 目录，但不忽略 build/important.js
build/
!build/important.js
# 注意：这样写不生效，因为 build/ 已经忽略了整个目录
# 正确写法：
build/*
!build/important.js

# 忽略 temp 目录及其所有内容
temp/

# 只忽略根目录的 temp 目录
/temp/

# 忽略所有名为 temp 的目录
**/temp/

1
2
3
4
5
6
7
8

# 匹配任意层级的目录
**/node_modules/     # 匹配任何位置的 node_modules

# 匹配特定模式
**/*.min.js         # 匹配任何位置的 .min.js 文件

# 匹配特定路径
**/build/output/    # 匹配任何 build/output 目录

1
2
3
4
5
6
7

# 这是注释

# 空行会被忽略

# 可以用反斜杠转义特殊字符
\#not-a-comment.txt  # 忽略名为 "#not-a-comment.txt" 的文件
\!important.txt      # 忽略名为 "!important.txt" 的文件

1
2
3
4
5
6
7
8
9

# 方法1：直接下载
# 访问 https://github.com/github/gitignore

# 方法2：使用 gibo 工具
# 安装 gibo
brew install gibo  # macOS

# 使用
gibo Node Python macOS >> .gitignore

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 1. 添加 .gitignore
echo "config.local.js" >> .gitignore

# 2. 修改 config.local.js
# ...

# 3. 查看状态
git status
# Changes not staged for commit:
#   modified:   config.local.js

# 文件仍然在追踪！

1
2
3
4
5
6
7
8
9

# 1. 停止追踪文件，但保留本地文件
git rm --cached config.local.js

# 2. 提交 .gitignore 和停止追踪的操作
git add .gitignore
git add config.local.js  # 这会记录 "删除" 操作
git commit -m "chore: 停止追踪 config.local.js，添加到 .gitignore"

# 3. 之后 config.local.js 的改动会被忽略

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# git rm --cached 做了什么？

# 执行前：
仓库：包含 config.local.js
暂存区：包含 config.local.js
工作区：包含 config.local.js

# 执行 git rm --cached 后：
仓库：包含 config.local.js（历史记录还在）
暂存区：标记为删除（下次提交会删除）
工作区：config.local.js 还在（保留本地文件）

# 提交后：
仓库：config.local.js 被删除（不再追踪）
暂存区：空
工作区：config.local.js 还在

1
2
3
4
5
6
7
8

# 停止追踪所有 .log 文件
git rm --cached *.log

# 停止追踪整个目录
git rm -r --cached logs/

# 提交更改
git commit -m "chore: 停止追踪日志文件"

1
2
3

# 停止追踪配置文件后，其他开发者需要重新创建这个文件
# 最好提供模板：
cp config.local.js.example config.local.js

1
2

# git rm --cached 只是停止追踪，历史记录中仍有该文件
# 如果文件包含敏感信息，需要更彻底的处理（见 8.9 节）

1
2
3
4
5
6
7
8

# 1. 创建全局 .gitignore 文件
touch ~/.gitignore_global

# 2. 配置 Git 使用它
git config --global core.excludesfile ~/.gitignore_global

# 3. 编辑全局 .gitignore
vim ~/.gitignore_global

1
2
3
4
5

# 查看全局 .gitignore 路径
git config --global core.excludesfile

# 查看所有生效的忽略规则
git check-ignore -v filename

1
2
3
4
5

# 问题：文件已经在 Git 中，.gitignore 对追踪的文件无效

# 解决：停止追踪
git rm --cached 文件
git commit -m "停止追踪文件"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 错误：缺少斜杠
node_modules    # 只忽略文件名为 node_modules 的文件
node_modules/   # 正确：忽略 node_modules 目录

# 错误：多余的斜杠
/build/         # 只忽略根目录的 build
build/          # 忽略任何位置的 build 目录

# 错误：模式不匹配
*.js.log        # 匹配 a.js.log
*.log           # 不匹配 a.js.log

1
2
3
4
5
6
7
8
9

# .gitignore
*.log           # 忽略所有 .log 文件
!important.log  # 不忽略 important.log
app.log         # 这行无效！因为 important.log 已经匹配了 *.log

# 正确写法：
*.log
!important.log
!app.log         # 要放在后面

1
2
3
4
5
6

# 有时候 Git 缓存了忽略规则

# 清除缓存，重新应用 .gitignore
git rm -r --cached .
git add .
git commit -m "刷新 .gitignore"

1
2
3
4
5
6
7
8
9

# 检查某个文件为什么被忽略/没被忽略
git check-ignore -v 文件路径

# 示例输出（被忽略）：
# .gitignore:3:*.log    app.log
# 表示：.gitignore 第 3 行的 *.log 规则忽略了 app.log

# 示例输出（没被忽略）：
# （无输出）