# .gitignore 快速参考

## 📝 快速检查命令

```bash
# 查看将要提交的文件
git status

# 验证敏感文件是否被忽略
git check-ignore .env .pypirc

# 查看所有被忽略的文件
git status --ignored

# 搜索敏感信息
grep -r "password\|secret\|api_key" --include="*.py" src/
```

## ⚠️ 绝对不要提交的文件

- [ ] `.env` - 环境变量文件
- [ ] `.pypirc` - PyPI 凭证
- [ ] `*.key`, `*.pem` - 私钥文件
- [ ] `credentials.json` - 凭证文件
- [ ] `.DS_Store` - macOS 系统文件
- [ ] `.idea/` - IDE 配置
- [ ] `__pycache__/` - Python 缓存
- [ ] `.venv/` - 虚拟环境
- [ ] `dist/`, `build/` - 构建产物

## ✅ 应该提交的文件

- [x] 所有源代码 (`src/`)
- [x] 测试代码 (`tests/`)
- [x] 文档 (`docs/`, `README.md`)
- [x] 配置文件 (`pyproject.toml`, `uv.lock`)
- [x] `.env.example` - 环境变量示例
- [x] `.gitignore` - Git 配置
- [x] `.python-version` - Python 版本

## 🚨 紧急：如果不小心提交了敏感文件

```bash
# 1. 从 Git 删除（保留本地文件）
git rm --cached .env

# 2. 提交删除操作
git commit -m "Remove .env from version control"

# 3. 立即轮换密钥/token！

# 4. 清理历史（如果已推送）
# 使用 BFG Repo-Cleaner 或 git-filter-repo
```

## 📚 更多信息

查看完整文档：`docs/git_best_practices.md`
