Cómo subir un proyecto a GitHub desde Visual Studio Code

Para subir tus proyectos a GitHub, lo primero que necesitas es tener una cuenta creada.

Una vez que tengas la cuenta lista, puedes abrir tu proyecto en Visual Studio Code o crear una carpeta de ejemplo para practicar el proceso.

Crear un repositorio en GitHub

Antes de hacer cualquier cosa en Visual Studio Code, hay que ir a GitHub.

Si ya tienes la cuenta creada y estás iniciado sesión, GitHub te va a mostrar su página principal. Desde ahí, debes tocar el botón que dice New para crear un nuevo repositorio.

Un repositorio es básicamente el lugar donde vas a subir todo tu código para que quede guardado en GitHub.

Al crear el repositorio, GitHub te va a pedir algunos datos:

• El dueño del repositorio, que por defecto será tu cuenta.
• El nombre del repositorio.
• Una descripción, que es opcional.
• Elegir si el repositorio será público o privado.

Conviene darle un nombre representativo al repositorio, relacionado con el proyecto que vas a subir.

La descripción es opcional, pero es recomendable si quieres que otras personas entiendan mejor de qué trata tu proyecto.

Elegir si el repositorio será público o privado

GitHub permite crear repositorios públicos o privados.

Si estás empezando, puede ser mejor crear el repositorio en público hasta que le agarres la mano a GitHub.

Esto puede evitar confusiones si tienes un error, porque cuando el repositorio está en privado puede aparecer un mensaje diciendo que no encuentra el repositorio y no siempre queda claro qué está pasando.

Por el momento, puedes dejar el repositorio en público y mantener las demás opciones como vienen por defecto, ya que se pueden cambiar más adelante.

Cuando tengas todo completado, debes presionar el botón verde que dice Create repository.

Copiar las instrucciones del repositorio

Después de crear el repositorio, GitHub te va a llevar a la página del repositorio.

Ahí aparecen unas instrucciones para conectar el repositorio con tus archivos locales.

Esas instrucciones son las que se van a utilizar para vincular el proyecto de tu computadora con el repositorio remoto de GitHub.

Abrir la terminal en Visual Studio Code

Ahora hay que volver a Visual Studio Code y abrir una terminal.

Desde esa terminal se van a ejecutar los comandos de Git para iniciar el repositorio local, agregar archivos, hacer commits y subir los cambios a GitHub.

Iniciar un repositorio local con Git

El primer comando que se utiliza es:

git init

Con este comando se inicia un repositorio de Git local en tu equipo.

Después de inicializar el repositorio, hay que volver a la página de GitHub y copiar la línea que dice git remote add origin junto con la URL del repositorio.

Ese comando sirve para vincular el repositorio local con el repositorio remoto.

git remote add origin URL_DEL_REPOSITORIO

Al presionar Enter, puede que no pase nada visible. Eso es totalmente normal.

Hacer un cambio en el proyecto

Después de vincular el repositorio local con GitHub, puedes hacer un cambio en tu proyecto.

Si ya estás trabajando sobre un proyecto real, probablemente ya tienes varios archivos creados.

Si estás haciendo una prueba, puedes crear un archivo sencillo, por ejemplo:

index.html

Luego puedes volver a la terminal y revisar el estado del proyecto.

Revisar el estado con git status

Para ver qué archivos tienen cambios, se usa el comando:

git status

Si hay archivos nuevos o modificados que Git todavía no está siguiendo, aparecerán marcados como archivos sin seguimiento.

Esto significa que Git todavía no está controlando esos archivos para incluirlos en el próximo commit.

Agregar archivos al commit

Para agregar archivos al próximo commit se usa el comando git add.

Si quieres agregar un archivo específico, puedes escribir:

git add index.html

Si quieres agregar todos los archivos que aparecen como nuevos o modificados, puedes usar:

git add .

Después de ejecutar el comando, puede que no aparezca ningún mensaje. Eso también es normal.

Si quieres verificar que se agregaron correctamente, puedes volver a ejecutar:

git status

Ahora los archivos deberían aparecer listos para el commit.

Crear el primer commit

Después de agregar los archivos, hay que crear el commit.

Para eso se usa el comando:

git commit -m "agregué el index html"

El mensaje del commit debe ser descriptivo, porque puede servir en el futuro si necesitas volver a un cambio anterior.

Por ejemplo, si agregaste el archivo index.html, puedes usar un mensaje como:

agregué el index html

Cuando presiones Enter, Git va a mostrar información sobre los cambios guardados.

Subir los archivos a GitHub

Hasta este punto, todo lo que hiciste fue local, es decir, dentro de tu computadora.

Para subir los archivos a GitHub, primero es recomendable revisar otra vez el estado del proyecto:

git status

Si todo está bien y no falta nada por guardar, ya puedes hacer el push.

git push

Si es la primera vez que haces un push a ese repositorio, puede aparecer un error porque todavía no está configurada la rama donde se van a subir los archivos.

En ese caso, Git normalmente muestra el comando que debes usar. Solo hay que copiarlo, pegarlo en la terminal y ejecutarlo.

Después de eso, los archivos se suben a GitHub.

Verificar los cambios en GitHub

Después de hacer el push, puedes volver a GitHub y actualizar la página del repositorio.

Las instrucciones iniciales ya no deberían aparecer y ahora se deben mostrar los archivos que subiste.

También vas a poder ver el commit que hiciste con su mensaje correspondiente.

Hacer un segundo cambio

Después del primer push, puedes hacer otro cambio para confirmar que todo funciona bien.

Por ejemplo, puedes crear una carpeta llamada:

css

Dentro de esa carpeta puedes crear un archivo de estilos.

Luego revisas el estado del proyecto:

git status

Si la carpeta o el archivo aparecen como cambios nuevos, puedes agregarlos con:

git add .

Después haces otro commit con un mensaje descriptivo:

git commit -m "agregué el css con su carpeta"

Y finalmente subes los cambios:

git push

Esta vez ya no debería pedir configurar la rama otra vez, porque eso se hizo en el primer push.

Comandos principales para subir un proyecto a GitHub

Comando	Para qué sirve
git init	Inicia un repositorio de Git local.
git remote add origin URL_DEL_REPOSITORIO	Conecta el repositorio local con GitHub.
git status	Muestra el estado de los archivos.
git add index.html	Agrega un archivo específico al commit.
git add .	Agrega todos los archivos modificados o nuevos.
git commit -m "mensaje"	Guarda los cambios con un mensaje descriptivo.
git push	Sube los cambios a GitHub.

Resumen del proceso

1. Crear o abrir el proyecto en Visual Studio Code.
2. Entrar a GitHub y crear un repositorio nuevo.
3. Copiar el comando git remote add origin del repositorio.
4. Abrir la terminal en Visual Studio Code.
5. Ejecutar git init.
6. Vincular el repositorio local con GitHub.
7. Revisar los cambios con git status.
8. Agregar archivos con git add ..
9. Crear un commit con git commit -m "mensaje".
10. Subir los cambios con git push.

Conclusión

Subir un proyecto a GitHub consiste en crear un repositorio, conectarlo con el proyecto local y usar comandos básicos de Git para guardar y subir los cambios.

El proceso principal se basa en iniciar el repositorio con git init, conectar el origen remoto, agregar archivos, crear commits y hacer push.

Una vez configurado el primer push, los siguientes cambios se pueden subir de forma más sencilla usando git add, git commit y git push.