miércoles, 15 de julio de 2026

Cómo crear un ZIP limpio de tu proyecto con Git

Git Archive para comprimir un repositorio Git

Si alguna vez necesitaste compartir tu proyecto, seguramente hiciste un .zip de toda la carpeta.

El problema es que ese archivo suele incluir elementos que no deberían compartirse, como:

  • .git
  • node_modules
  • archivos temporales
  • configuraciones locales
  • otros archivos ignorados por Git

Una forma más limpia y rápida es usar git archive.

Video


Comprime tu proyecto con un solo comando

Ejecuta el siguiente comando desde la raíz de tu repositorio:

git archive -o aniballinux-android-git.zip HEAD

Esto genera un archivo ZIP que contiene únicamente los archivos versionados en Git.

No incluye archivos ignorados por .gitignore ni la carpeta .git.

Git archive en la terminal

¿Por qué usar git archive?

Estas son algunas ventajas:

  • El ZIP pesa menos.
  • No expone archivos sensibles.
  • No incluye configuraciones personales.
  • Es ideal para compartir código con clientes, estudiantes o compañeros.
  • No necesitas instalar herramientas adicionales.

Comparación

Un archivo comprimido manualmente suele incluir muchos archivos innecesarios.

En cambio, git archive solo empaqueta el contenido que realmente forma parte del proyecto.

Compresión tradicional

El archivo aniballinux-android.zip fue comprimido de forma manual.

Su tamaño es mayor porque incluye archivos que no son necesarios para compartir el proyecto.

Usando git archive

El archivo aniballinux-android-git.zip es mucho más limpio y ligero, ya que únicamente contiene los archivos versionados.

Comparativa entre ZIP manual y Git Archive

Segunda opción: descargar el ZIP desde GitHub

También puedes descargar un ZIP directamente desde tu repositorio en GitHub.

Esta opción funciona bien, pero tiene algunas desventajas:

  • Necesitas conexión a Internet.
  • Debes subir previamente el proyecto al repositorio remoto.
  • Requiere un paso adicional.

Aun así, es una buena alternativa cuando deseas compartir una versión publicada.

Descargar ZIP desde GitHub

¿Cuándo conviene usar git archive?

Es una excelente opción cuando quieres:

  • Compartir un proyecto.
  • Enviar código a un cliente.
  • Publicar ejemplos.
  • Crear entregables para estudiantes.
  • Generar una copia limpia del repositorio.

Si tu proyecto ya está versionado con Git, probablemente sea la forma más sencilla de generar un ZIP.


Conclusión

git archive es un comando simple, pero muy útil.

Te permite generar un archivo ZIP limpio, ligero y sin archivos innecesarios. Si compartes proyectos con frecuencia, puede ahorrarte tiempo y evitar exponer información que no debería salir de tu equipo.


⭐ Recomendado

Tengo un ebook donde comparto tips, herramientas y experiencia real usando Linux como developer 🚀 Si quieres ayuda para migrar o configurar tu entorno Linux, también puedes contactarme 🙂

Autor: Anibal Copitan ()

No hay comentarios: