【Git江湖秘典——禁制、心法与渡劫篇】

Git江湖秘典——禁制、心法与渡劫篇

gitignore：门派禁书目录

作用：
Gitignore 是一个文本文件，用于告诉 Git 哪些文件或目录不需要纳入版本控制。就像门派的「禁书目录」，明确哪些文件不能上传到总舵（远程仓库），避免泄露垃圾文件或敏感信息。

---

1. 禁书目录的写法与规则

核心作用：

• 屏蔽临时文件：如编译生成的 .class、.pyc、.tmp。
• 隐藏系统文件：如 Mac 的 .DS_Store、Windows 的 Thumbs.db。
• 排除构建产物：如 build/、dist/ 文件夹，由总舵自动生成。
• 保护敏感信息：如配置文件中的密码、API 密钥（需配合 .env.example 提供模板）。

---

规则语法（重点）

常用规则：

1. 单文件屏蔽：

   error.log    # 屏蔽单个 error.log 文件  
   

2. 通配符屏蔽：

   *.tmp        # 屏蔽所有 .tmp 后缀的文件  
   !important.tmp  # 例外：排除某个不屏蔽的文件  
   

3. 目录屏蔽：

   /logs/       # 屏蔽 logs 目录及其子目录  
   !/logs/important.log  # 例外：保留 logs 目录下的重要日志  
   

4. 注释与空行：

   # 这是注释：屏蔽所有 .cache 文件  
   .cache/  
   

扩展技巧（28%常用）：

• 全局 Gitignore：
  如果某些文件（如 IDE 的 .idea/）是全局需要屏蔽的，可在用户目录下创建 ~/.gitignore_global，并通过 git config --global core.excludesfile ~/.gitignore_global 全局生效。
• 模板库：
  GitHub 提供了常见项目的 Gitignore 模板（如 Python.gitignore），可直接复制使用。

---

2. 常见场景与示例文件

示例：一个