.gitignore 与文件管理

# 这是注释——以 # 开头的行被忽略
# 空行也被忽略

# 直接匹配文件名（匹配任何目录层级下的同名文件）
debug.log

# 匹配特定扩展名
*.o
*.class

# 匹配目录（末尾的 / 表示只匹配目录，不匹配同名文件）
build/
node_modules/

# 匹配根目录下的文件/目录（开头的 / 表示相对于 .gitignore 所在目录的根）
/TODO
/dist

# 取反（!）——即使前面被忽略，也重新纳入跟踪
!important.log

# 双星号（**）——跨目录匹配
src/**/temp/

build/          # 只忽略名为 build 的目录，不忽略名为 build 的文件
build           # 同时忽略名为 build 的目录和文件

/TODO           # 只忽略 .gitignore 所在目录根下的 TODO 文件
TODO            # 忽略任何目录层级下的 TODO 文件

# 忽略所有 .log 文件
*.log

# 但 important.log 除外——不要忽略它
!important.log

# 忽略 build 目录下的一切
build/

# 但保留 build/essential/ 目录的内容
!build/essential/

# 这组规则不会按预期工作
build/           # 忽略 build 目录
!build/essential/ # 试图恢复——但 Git 不会进入 build/ 去检查子项

build/*
!build/essential/

src/**/test.js       # 匹配 src 下任何层级中的 test.js
                      # 如 src/test.js、src/a/test.js、src/a/b/c/test.js

**/logs              # 匹配任何层级下的 logs 目录或文件
                      # 如 logs/、a/logs/、a/b/logs/

logs/**              # 匹配 logs 目录下的任何内容（任意深度）

# 忽略所有 .log 文件
*.log

# 但保留 important.log
!important.log

# 忽略 debug 目录下的一切
debug/*

# 但保留 debug/config.json
!debug/config.json

# 设置全局 gitignore 文件路径
git config --global core.excludesFile ~/.gitignore_global

# 编辑全局 gitignore
cat > ~/.gitignore_global << 'EOF'
# macOS
.DS_Store
.AppleDouble
.LSOverride

# IDE
.idea/
.vscode/
*.swp
*.swo

# Linux
*~
.fuse_hidden*

# Windows
Thumbs.db
ehthumbs.db
Desktop.ini
EOF

# 依赖
node_modules/
vendor/

# 构建产物
dist/
build/
*.min.js
*.min.css

# 环境配置（含敏感信息）
.env
.env.local
.env.*.local

# 日志
*.log
npm-debug.log*

# 测试覆盖率
coverage/

project/
├── .gitignore              # 项目级——对整个项目生效
├── src/
│   ├── .gitignore          # 目录级——只对 src/ 及其子目录生效
│   ├── generated/
│   │   └── .gitignore      # 更深层级——只对 generated/ 生效
│   └── main.py
└── docs/
    └── ...

# 忽略此目录下所有自动生成的文件
*

# 1. 不小心提交了 debug.log
git add debug.log
git commit -m "add debug log"

# 2. 后来意识到不该跟踪它，加入 .gitignore
echo "debug.log" >> .gitignore

# 3. 但修改 debug.log 后，git status 仍然显示它被修改！
git status
# Changes not staged for commit:
#   modified:   debug.log

# 从索引中移除文件，但保留工作区文件
git rm --cached debug.log

# 现在再查看状态
git status
# Deleted:   debug.log        （索引中已删除）
# Untracked: debug.log        （工作区仍存在，但被 .gitignore 忽略）

# 提交这个变更
git commit -m "stop tracking debug.log"

# 先确保 .gitignore 已正确配置
# 然后从索引中移除所有被 .gitignore 匹配的文件
git rm -r --cached .

# 重新添加（此时 .gitignore 会生效，被忽略的文件不会被加入）
git add .

# 提交
git commit -m "apply .gitignore rules, remove tracked ignored files"

# 检查特定文件被哪条规则忽略
git check-ignore -v debug.log
# 输出：.gitignore:3:*.log    debug.log
# 含义：.gitignore 文件第 3 行的 *.log 规则匹配了 debug.log

# 如果文件未被忽略，该命令无输出
git check-ignore -v important.log
# （无输出——说明该文件未被任何忽略规则匹配）

# 使用 git filter-branch（传统方式，较慢）
git filter-branch --force --index-filter \
  'git rm --cached --ignore-unmatch secrets.env' \
  --prune-empty --tag-name-filter cat -- --all

# 或使用 git filter-repo（推荐，更快更安全）
# 需要先安装：pip install git-filter-repo
git filter-repo --path secrets.env --invert-paths

# 清理引用和垃圾回收
rm -rf .git/refs/original/
git reflog expire --expire=now --all
git gc --prune=now --aggressive

# 1. 预览：哪些未跟踪文件将被删除
git clean -n
# Would remove debug.log
# Would remove temp/

# 2. 预览：包含目录
git clean -n -d
# Would remove debug.log
# Would remove temp/
# Would remove build/    （未跟踪的目录）

# 3. 实际删除未跟踪文件和目录
git clean -fd
# Removing debug.log
# Removing temp/

# 4. 同时删除被 .gitignore 忽略的文件（危险！）
git clean -fdx
# Removing node_modules/   （被 .gitignore 忽略的目录也会被删除）
# Removing dist/           （被 .gitignore 忽略的构建产物）

# 5. 交互模式——逐个确认
git clean -i
# Would remove the following items:
#   debug.log  temp/
# *** Commands ***
#   1: clean    2: filter by pattern    3: select by numbers
#   4: ask each    5: quit
# What now> 4
# Remove debug.log? y
# Remove temp/? n

# 场景：构建出现问题，想完全从头开始
# 1. 重置所有已跟踪文件的修改
git reset --hard

# 2. 删除所有未跟踪文件（包括被忽略的构建产物和依赖）
git clean -fdx

# 现在工作区与最新提交完全一致
# 3. 重新安装依赖、重新构建
npm install   # 或 pip install、mvn install 等

# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# C extensions
*.so

# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
pip-wheel-metadata/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST

# PyInstaller
*.manifest
*.spec

# Installer logs
pip-log.txt
pip-delete-this-directory.txt

# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/

# Translations
*.mo
*.pot

# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/

# Spyder project settings
.spyderproject
.spyproject

# Rope project settings
.ropeproject

# mkdocs documentation
/site

# mypy
.mypy_cache/
.dmypy.json
dmypy.json

# Pyre type checker
.pyre/

# Jupyter Notebook
.ipynb_checkpoints

# Dependencies
node_modules/
jspm_packages/

# Build output
dist/
build/
.next/
out/
.nuxt/

# Logs
logs/
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*

# Runtime data
pids/
*.pid
*.seed
*.pid.lock

# Directory for instrumented libs generated by jscoverage/JSCover
lib-cov/

# Coverage directory used by tools like Istanbul
coverage/
*.lcov

# nyc test coverage
.nyc_output/

# Dependency directories
node_modules/

# TypeScript cache
*.tsbuildinfo

# Optional npm cache directory
.npm

# Optional eslint cache
.eslintcache

# Optional REPL history
.node_repl_history

# Output of 'npm pack'
*.tgz

# Yarn Integrity file
.yarn-integrity

# dotenv environment variables file
.env
.env.local
.env.development.local
.env.test.local
.env.production.local

# parcel-bundler cache
.cache/
.parcel-cache/

# Vite
.vite/

# Docusaurus
.docusaurus/

# Compiled class file
*.class

# Log file
*.log

# BlueJ files
*.ctxt

# Mobile Tools for Java (J2ME)
.mtj.tmp/

# Package Files
*.jar
*.war
*.nar
*.ear
*.zip
*.tar.gz
*.rar

# Virtual machine crash logs
hs_err_pid*
replay_pid*

# Maven
target/
pom.xml.tag
pom.xml.releaseBackup
pom.xml.versionsBackup
pom.xml.next
release.properties

# Gradle
.gradle/
**/build/
!src/**/build/

# Ignore Gradle GUI config
gradle-app.setting

# Avoid ignoring Gradle wrapper jar file
!gradle-wrapper.jar

# Cache of project
.gradletasknamecache

# IntelliJ IDEA
.idea/
*.iws
*.iml
*.ipr

# Eclipse
.apt_generated/
.classpath
.factorypath
.project
.settings/
.springBeans
.sts4-cache/

# NetBeans
/nbproject/private/
/nbbuild/
/dist/
/nbdist/
/.nb-gradle/

# VS Code
.vscode/

# Prerequisites
*.d

# Compiled Object files
*.slo
*.lo
*.o
*.obj

# Precompiled Headers
*.gch
*.pch

# Compiled Dynamic libraries
*.so
*.dylib
*.dll

# Fortran module files
*.mod
*.smod

# Compiled Static libraries
*.lai
*.la
*.a
*.lib

# Executables
*.exe
*.out
*.app

# Debug files
*.dSYM/
*.su
*.idb
*.pdb

# Kernel Module Compile Results
*.mod*
*.cmd
.tmp_versions/
modules.order
Module.symvers
Mkfile.old
dkms.conf

# CMake
CMakeLists.txt.user
CMakeCache.txt
CMakeFiles/
CMakeScripts/
cmake_install.cmake
install_manifest.txt
compile_commands.json
CTestTestfile.cmake
_deps/

# Make
*.d
*.depend

# 创建新项目时，直接合并对应模板
curl -o .gitignore https://raw.githubusercontent.com/github/gitignore/main/Python.gitignore

# 或使用更完整的组合模板（如 Python + JetBrains + macOS）
cat > .gitignore << 'EOF'
# ===== Python =====
$(curl -s https://raw.githubusercontent.com/github/gitignore/main/Python.gitignore)

# ===== JetBrains =====
$(curl -s https://raw.githubusercontent.com/github/gitignore/main/Global/JetBrains.gitignore)

# ===== macOS =====
$(curl -s https://raw.githubusercontent.com/github/gitignore/main/Global/macOS.gitignore)
EOF