Cómo usar git clone en Ubuntu: Guía completa para principiantes sobre cómo clonar repositorios Git

.

1. Introducción

En los últimos años, Git se ha convertido en una herramienta indispensable en el desarrollo de software, la investigación y los proyectos personales. Como sistema de control de versiones usado en todo el mundo, Git desempeña un papel fundamental en la compartición y gestión de código para el desarrollo en equipo y los proyectos de código abierto.

Este artículo explica, de forma amigable para principiantes, cómo duplicar (clonar) un repositorio Git en Ubuntu, una distribución Linux muy popular, usando el comando git clone.
git clone es uno de los comandos más básicos que se utilizan para copiar un repositorio remoto completo —por ejemplo, proyectos alojados en GitHub o GitLab— a tu entorno local.

Al dominar git clone, los usuarios de Ubuntu pueden instalar sin problemas diversos proyectos de software de código abierto y crear sus propios entornos de desarrollo.
Además, la participación en equipos y comunidades será mucho más activa.

Este artículo ofrece una visión general completa, abarcando la instalación de Git, el uso básico de git clone y cómo manejar errores comunes.
Resulta útil no solo para quienes son nuevos en Git en Ubuntu, sino también para usuarios que desean organizar y reforzar sus conocimientos existentes.

2. Requisitos previos y configuración del entorno

Para usar git clone en Ubuntu, es necesario que Git esté instalado. Además, la configuración inicial y la preparación de la autenticación para acceder a repositorios remotos son importantes. Esta sección explica el proceso de configuración paso a paso.

2.1 Instalación de Git

En Ubuntu, Git se puede instalar fácilmente desde los repositorios oficiales. Abre una terminal y ejecuta los siguientes comandos en el orden indicado.

sudo apt update
sudo apt install git

Después de la instalación, verifica que Git se haya instalado correctamente mostrando la información de la versión.

git --version

Si se muestra la información de la versión, la instalación fue exitosa.

2.2 Configuración de tu nombre de usuario y dirección de correo electrónico

Git registra quién realizó los cambios, cuándo se hicieron y qué se modificó. Por lo tanto, al usar Git por primera vez, debes configurar tu nombre de usuario y tu dirección de correo electrónico.

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

Esta configuración solo necesita hacerse una vez y se aplicará a todas las operaciones de Git. Si deseas establecer valores diferentes por proyecto, omite --global y ejecuta el comando dentro del directorio del proyecto.

2.3 Elección y preparación de un método de autenticación

Al acceder a repositorios remotos con Git, existen dos métodos principales de autenticación: HTTPS y SSH.

• HTTPS El acceso se realiza mediante una URL, similar a un navegador web. En plataformas como GitHub y GitLab, la autenticación con contraseña ha sido descontinuada y se recomienda el uso de Tokens de Acceso Personal (PAT).
• SSH La autenticación se lleva a cabo mediante un par de claves pública y privada. Este método es muy seguro y elimina la necesidad de introducir una contraseña cada vez, lo que lo hace ideal para usuarios que utilizan Git con frecuencia.

2.4 Uso de Git Credential Manager (opcional)

Si deseas gestionar contraseñas o tokens de acceso de forma más segura y cómoda, considera instalar Git Credential Manager (GCM).
GCM almacena la información de autenticación de manera segura y elimina la necesidad de ingresarla repetidamente. En Ubuntu, puede instalarse a través de la documentación oficial o de los repositorios de paquetes.

Esto completa la preparación necesaria para usar git clone en Ubuntu.
En la siguiente sección, cubriremos los pasos básicos para clonar realmente un repositorio usando el comando git clone.

3. Uso básico de git clone

El comando git clone es una orden fundamental que se utiliza para copiar el contenido de un repositorio remoto completo a tu entorno local. Cuando deseas usar un repositorio creado por otra persona en un proyecto de código abierto o en desarrollo en equipo, la primera operación que realizas suele ser git clone.

3.1 Sintaxis básica del comando

El uso más sencillo se muestra a continuación.

git clone <repository URL>

Por ejemplo, al clonar un repositorio público alojado en GitHub:

git clone https://github.com/exampleuser/sample-project.git

Al ejecutar este comando, se crea una nueva carpeta llamada sample-project en el directorio actual y se descargan todos los contenidos del repositorio dentro de ella.

3.2 Clonar mediante HTTPS

Clonar mediante HTTPS se usa habitualmente en muchos servicios. La URL comienza con https://. Es posible que se le solicite ingresar información de autenticación (nombre de usuario y Token de Acceso Personal) durante la primera operación.

git clone https://github.com/username/repository-name.git

3.3 Clonar mediante SSH

Si tiene una clave SSH registrada, puede clonar de forma segura sin introducir una contraseña. Las URLs SSH suelen usar el formato git@github.com:.

git clone git@github.com:username/repository-name.git

Para usar la clonación SSH, debe registrar su clave pública en GitHub, GitLab u otro servicio de alojamiento con antelación.

3.4 Estructura del repositorio después de clonar

Al ejecutar git clone, se copian todos los archivos y directorios del repositorio, junto con el directorio .git que contiene la información de control de versiones.

• Directorio .git Este directorio almacena el historial y la configuración del repositorio. Su presencia indica que todos los archivos en la carpeta están gestionados por Git.
• Directorio de trabajo Contiene el código fuente del proyecto y la documentación con la que interactúa durante el desarrollo.

3.5 Ten cuidado con el directorio actual

El comando git clone crea un nuevo directorio en la ubicación donde se ejecuta. Se recomienda cambiar al directorio de destino deseado usando el comando cd antes de ejecutarlo.

4. Clonar una rama específica

Los repositorios Git suelen contener múltiples ramas. De forma predeterminada, git clone clona la rama principal (como main o master), pero hay muchos casos en los que se desea clonar solo una rama específica. Esta sección explica cómo hacerlo.

4.1 Usando la opción –branch

El comando git clone ofrece la opción --branch (o -b). Esto permite clonar un repositorio con una rama especificada ya seleccionada.

git clone --branch branch-name repository-URL

Por ejemplo, para clonar la rama develop:

git clone --branch develop https://github.com/exampleuser/sample-project.git

Esto crea un repositorio local con la rama develop ya revisada.

4.2 Combinando con la opción –single-branch

De forma predeterminada, git clone descarga información de todas las ramas. Sin embargo, al combinarlo con la opción --single-branch, solo se recupera la rama especificada, reduciendo el uso de disco y el tráfico de red.

git clone --branch branch-name --single-branch repository-URL

Esto es útil cuando solo necesita una rama de característica específica o cuando trabaja con repositorios grandes.

4.3 Obteniendo otras ramas después de clonar

Si más adelante decide que necesita ramas adicionales, ejecute el siguiente comando dentro del repositorio.

git fetch --all

Luego cambie a la rama deseada con:

git checkout branch-name

4.4 Notas importantes

• Se requiere autenticación para repositorios privados o restringidos.
• Especificar un nombre de rama que no exista producirá un error. Se recomienda comprobar los nombres de rama disponibles en el repositorio remoto con antelación.

5. Errores comunes y cómo solucionarlos

Al usar git clone, pueden aparecer errores debido a problemas de autenticación, conectividad o permisos. Esta sección presenta los errores más comunes que encuentran los usuarios de Ubuntu y sus soluciones.

5.1 Errores de autenticación HTTPS y uso de tokens de acceso personal

Para mejorar la seguridad, plataformas como GitHub y GitLab han dejado de admitir la autenticación con contraseña y ahora requieren Tokens de Acceso Personal (PAT).
Puede encontrarse con errores como el siguiente:

remote: Support for password authentication was removed...
fatal: Authentication failed for 'https://github.com/...'

En este caso, genera un PAT en GitHub e ingresa el nombre de tu cuenta de GitHub como usuario y el PAT como contraseña. Los PAT se pueden crear desde Configuración de GitHub → Configuración del desarrollador → Tokens de acceso personal.

5.2 Errores de Autenticación SSH y Registro de Claves Públicas

Al clonar mediante SSH, es posible que veas el error Permission denied (publickey). Esto generalmente indica que la clave SSH no se ha registrado correctamente.

Solución:

1. Genera una clave SSH si no tienes una ya:

   ssh-keygen -t ed25519 -C "your.email@example.com"
   

2. Copia la clave pública:

   cat ~/.ssh/id_ed25519.pub
   

3. Agrega la clave pública a la configuración de tu cuenta de GitHub o GitLab.

Esto resuelve los errores de autenticación SSH.

5.3 Errores de Permisos de Acceso al Repositorio

Al intentar clonar un repositorio privado o propiedad de una organización, es posible que veas errores como el siguiente:

fatal: repository 'https://github.com/username/repository-name.git/' not found

Solución:

• Verifica que la URL del repositorio sea correcta.
• Confirma que tu cuenta tenga permiso para acceder al repositorio.
• Vuelve a ingresar las credenciales de autenticación si es necesario.

5.4 Errores Relacionados con la Red

Errores como Connection timed out o Could not resolve host suelen ser causados por problemas de conectividad a internet o configuraciones de proxy.

Solución:

• Asegúrate de que tu conexión a internet esté activa.
• Revisa las configuraciones de VPN o proxy si aplica.
• Si el problema es causado por una interrupción temporal del servicio, espera y reintenta más tarde.

5.5 Otros Errores Comunes

• Directorio Ya Existe La clonación falla si ya existe un directorio con el mismo nombre. Renombra el directorio o elimina el existente.
• Espacio en Disco Insuficiente Asegúrate de que haya suficiente espacio en disco libre disponible.

Al identificar la causa y abordarla paso a paso, la mayoría de los errores se pueden resolver exitosamente.

6. Opciones Útiles de git clone

El comando git clone proporciona una variedad de opciones que te permiten recuperar solo los datos que necesitas o clonar correctamente repositorios con submódulos. Esta sección introduce algunas de las opciones más comúnmente usadas.

6.1 Opción –depth (Clonación Superficial)

Si no necesitas el historial completo de commits y solo quieres los commits más recientes, la opción --depth es útil.
Te permite limitar el número de commits recuperados.

git clone --depth 1 https://github.com/exampleuser/sample-project.git

Este ejemplo recupera solo el commit más reciente. Es ideal para repositorios grandes o entornos de CI donde la velocidad es importante.

6.2 Opción –single-branch

Por defecto, git clone recupera información para todas las ramas. Usar la opción --single-branch te permite clonar solo una rama específica.
A menudo se combina con la opción --branch.

git clone --branch develop --single-branch https://github.com/exampleuser/sample-project.git

6.3 Opción –recursive (Clonación de Submódulos)

Los repositorios de Git pueden incluir otros repositorios como submódulos. Al clonar tales proyectos, usa la opción --recursive.

git clone --recursive https://github.com/exampleuser/sample-project.git

Esto clona tanto el repositorio principal como sus submódulos. Si olvidaste incluir --recursive, puedes inicializar los submódulos después:

git submodule update --init --recursive

6.4 Otras Opciones Útiles

• Opción –origin Se usa cuando quieres asignar un nombre remoto diferente al predeterminado origin .
• Especificar un Nombre de Directorio Para especificar explícitamente el nombre del directorio de destino, agrégalo al final del comando.

  git clone https://github.com/exampleuser/sample-project.git custom-directory-name
  

7. Usando git clone con Herramientas GUI

Si no te sientes cómodo con operaciones de línea de comandos o prefieres una interfaz más intuitiva, las herramientas GUI son una gran alternativa. En Ubuntu, varias herramientas GUI te permiten realizar git clone fácilmente.

7.1 Herramientas GUI Populares

.

• Gittyup Un cliente Git ligero y sencillo, instalable a través de los repositorios de Ubuntu o Flatpak.
• Visual Studio Code (VS Code) Un editor popular que soporta operaciones Git intuitivas mediante extensiones.
• GitKraken Un cliente Git con muchas funciones y una interfaz visualmente intuitiva (gratuito para uso personal).

7.2 Clonar con Gittyup

1. Instala Gittyup (p. ej., sudo apt install gittyup o mediante Flatpak).
2. Abre la aplicación y haz clic en “Clonar repositorio”.
3. Introduce la URL del repositorio, elige una carpeta de destino y ejecuta la clonación.

7.3 Clonar con Visual Studio Code

1. Abre VS Code y haz clic en el ícono de “Control de código fuente” en la barra izquierda.
2. Selecciona “Clonar repositorio” en el menú superior.
3. Pega la URL del repositorio, presiona Enter y elige una carpeta de destino.
4. Después de clonar, puedes editar el código, confirmar cambios y subir actualizaciones directamente desde VS Code.

7.4 Ventajas y consideraciones de las herramientas GUI

• Ventajas No se requiere introducir comandos, lo que las hace amigables para principiantes. Las diferencias y el historial son fáciles de visualizar.
• Consideraciones Las funciones y la interfaz varían según la herramienta, por lo que debes elegir la que se ajuste a tu flujo de trabajo. Empezar con herramientas GUI y, poco a poco, aprender la línea de comandos brinda mayor flexibilidad.

8. Resumen

Este artículo ofrece una explicación detallada de cómo usar git clone en Ubuntu, desde conceptos básicos hasta usos avanzados.
Se cubren la instalación de Git, los métodos de clonación por HTTPS y SSH, el trabajo con ramas específicas, opciones útiles y flujos de trabajo basados en GUI.

git clone es un comando esencial para proyectos de código abierto, desarrollo en equipo y auto‑aprendizaje. Una vez que lo domines, podrás trabajar de forma eficiente en muchos escenarios.

Para principiantes, un buen enfoque es buscar los mensajes de error directamente, consultar la documentación oficial y explorar gradualmente opciones avanzadas y herramientas GUI a medida que adquieras experiencia.

Si encuentras preguntas que no se abordan en este artículo, consulta las FAQ, la documentación oficial de GitHub o los recursos de la comunidad.
Aprovecha la combinación de Ubuntu y Git para ampliar tus oportunidades de desarrollo y aprendizaje.

9. FAQ (Preguntas frecuentes)

P1: ¿Cómo instalo Git en Ubuntu?
R1: Ejecuta los siguientes comandos en la terminal:

sudo apt update
sudo apt install git

P2: ¿Cómo puedo clonar solo una rama específica?
R2: Usa la opción --branch (o -b).
Ejemplo:

git clone --branch branch-name repository-URL

P3: Obtengo un error de autenticación al clonar vía HTTPS. ¿Qué debo hacer?
R3: Utiliza un Token de Acceso Personal en lugar de una contraseña. Genera uno en la configuración de tu cuenta de GitHub y pégalo en el prompt de contraseña.

P4: ¿Cómo creo y registro una clave SSH?
R4: Genera una clave SSH con:

ssh-keygen -t ed25519 -C "your.email@example.com"

P5: ¿Cómo puedo comprobar la URL remota de un repositorio clonado?
R5: Ejecuta el siguiente comando dentro del repositorio:

git remote -v

P6: ¿Qué ocurre si ya existe un directorio con el mismo nombre?
R6: git clone fallará. Especifica un nombre de directorio diferente o elimina el directorio existente.

P7: ¿Cómo clono correctamente un repositorio con submódulos?
R7: Usa la opción --recursive:

git clone --recursive repository-URL

P8: ¿Qué herramientas GUI de Git se recomiendan para Ubuntu?
R8: Gittyup, Visual Studio Code (con extensiones Git) y GitKraken son opciones populares.

P9: ¿Cómo cambio a otra rama después de clonar?
R9:

git fetch --all
git checkout branch-name