Sinopsis

git count-objects [-v] [-H]

Descripción

El comando git count-objects reporta cuántos objetos sueltos hay en .git/objects/ y cuánto espacio en disco usan. Con -v, también incluye estadísticas de packs y objetos basura.

Útil para monitorear cuándo es momento de ejecutar git gc: muchos objetos sueltos indican que el repo se beneficiaría del empaquetamiento.

En el uso diario, este comando se integra estrechamente con alias de shell, plugins de editor e integración continua. Los usuarios avanzados a menudo añaden alias que combinan los flags que siempre pasan. El formato de salida puede personalizarse vía configuración de Git. Cuando algo sale mal, ejecuta el comando con GIT_TRACE=1 para revelar las llamadas plumbing subyacentes.

Entender cómo este comando interactúa con el resto del modelo de datos de Git rinde dividendos. Cada comando opera sobre algún subconjunto de las piezas (objetos, index, refs, árbol de trabajo), y saber cuáles toca ayuda a predecir resultados y a recuperarse de errores.

Cuándo usar

Run git count-objects -v to gauge whether a repo needs git gc: if loose-object count is high or there are many small packs, garbage collection will compact things. CI and ops teams use it for monitoring repo health.

Opciones comunes

Ejemplos

git count-objects
# Quick: number of loose objects and their size

git count-objects -vH
# Full breakdown with human-readable sizes
# count: 235 (loose objects)
# size: 5.2 MiB
# in-pack: 18234
# packs: 3
# size-pack: 142.6 MiB
# prune-packable: 12
# garbage: 0

Errores comunes

Misreading "garbage" — these are corrupt objects, not just unreachable ones. A non-zero garbage count warrants investigation. prune-packable indicates objects present both loose and in packs; running git gc will resolve them.

Comandos relacionados

git gc, git fsck, git repack, git verify-pack