如果文件已被提交，到底如何加入 .gitignore，具体步骤是怎样的？

一、正确操作步骤（已提交文件加入.gitignore）

场景：

假设项目中已提交了 config/database.yml（含敏感信息），现在需要忽略它。

步骤：

1. 添加到 .gitignore

   echo "config/database.yml" >> .gitignore
   

2. 从Git跟踪中删除（保留本地文件）

   git rm --cached config/database.yml
   

   • --cached 选项表示只删除Git跟踪，保留本地文件。

3. 提交更改

   git commit -m "Stop tracking database.yml"
   

4. 推送到远程仓库

   git push origin main
   

验证：

执行 git status，应该看到 config/database.yml 不再显示为已修改（但仍存在于本地）。

二、使用场景

1. 误提交敏感信息

• 密码、API密钥、数据库配置等。
• 例：已提交 .env 文件，需立即停止跟踪。

2. 优化仓库体积

• 大文件（如日志、编译产物）已提交，需清理。
• 例：删除已提交的 node_modules。

3. 统一团队配置

• 团队成员使用不同IDE，需忽略各自的配置文件。
• 例：删除已提交的 .vscode/settings.json。

三、底层实现（简化版）

1. 软件层面

• Git的文件跟踪机制：

  • Git通过 .git/index 文件记录当前暂存区的文件状态。
  • git rm --cached 的操作：
    1. 从 .git/index 中删除文件记录（不再跟踪）。
    2. 保留工作区的实际文件（不删除本地文件）。
    3. 下次提交时，Git会记录“此文件已删除”的变更。

• 忽略规则生效逻辑：

  • .gitignore 只对未被跟踪的文件生效。
  • 当文件已被提交（在历史中），需先从暂存区删除，再由 .gitignore 阻止重新跟踪。

2. 硬件层面

• 文件系统操作：

  • git rm --cached 实际修改了：
    • .git/index 文件（内存中更新后写入磁盘）。
    • 下一次提交时，在 .git/objects 中生成新的提交对象。
  • 本地文件 config/database.yml 保持不变。

• 性能影响：

  • 删除大量文件可能导致提交对象变大，因为需要记录“删除”操作。
  • 历史记录中仍保留文件内容（需用 git filter-repo 彻底删除）。

四、注意事项

1. 历史记录中的文件仍存在

   • git rm --cached 只影响未来的提交，历史版本中文件依然可见。
   • 若需彻底删除历史记录，需用 git filter-repo（但会改变所有提交哈希）。

2. 团队协作同步

   • 所有成员需拉取最新提交，否则本地修改可能重新提交被忽略的文件。

3. 安全敏感信息

   • 若已公开包含敏感信息的提交，需立即：
     1. 撤销密钥/密码。
     2. 使用 git filter-repo 清理历史。
     3. 部署新密钥。

五、总结

最佳实践：

• 项目初始化时尽早创建 .gitignore，避免后续清理麻烦。
• 使用 git ls-files --ignored --exclude-standard 检查已忽略的文件。 😊