Módulo de Laboratorio

Preparar el
entorno

Visual Studio Code · Git · GitHub

Profesor
Sandro Hurtado Requena
Hoja de ruta

Tu banco de trabajo

01

Markdown

  • El formato de las guías de laboratorio
02

La terminal

  • Dónde escribiremos los comandos
03

VS Code

  • El editor que usaremos en clase
04

Git + GitHub

  • Historial del código y colaboración

Todos los pasos, para Windows, macOS y Linux, están en la guía GUIA.md del repositorio del curso.

Formato de las guías

¿Qué es Markdown?

GUIA.md · lo que escribes
# Guía de instalación

Instala **Git** y comprueba la versión:

```bash
git --version
```

## Enlaces
- [Documentación](https://git-scm.com)

Guía de instalación

Instala Git y comprueba la versión:

git --version

Enlaces

lo que ves en GitHub o en VS Code

Formato de las guías

Lo usaremos mucho

  • Texto plano con marcas sencillas: se lee bien incluso sin formato
  • Las guías de laboratorio del curso son archivos .md
  • También en los README.md, los notebooks y la documentación técnica

Vista previa en VS Code: ⇧⌘V (macOS) o Ctrl+Shift+V

EscribesObtienes
# TítuloTítulo principal
## ApartadoSubtítulo
**negrita** · *cursiva*negrita · cursiva
- elementoLista
[texto](url)Enlace
`código`Código en línea
```bash … ```Bloque de código
Hablar con el ordenador escribiendo

La terminal

  • Das órdenes al sistema operativo con texto en lugar de con el ratón
  • Es la forma de instalar herramientas, usar Git y Docker o trabajar en servidores sin interfaz gráfica
  • Lo que escribes se puede repetir, compartir y automatizar

Windows

Windows Terminal con PowerShell

macOS

App Terminal con zsh

Linux

Ctrl+Alt+T con bash

VS Code trae una terminal integrada: Ctrl+`

La terminal en las guías

Leer los comandos

  • $ → macOS y Linux (bash / zsh)
  • > → Windows (PowerShell)
  • No copies el $ ni el >: solo lo que va detrás
  • Tras instalar algo, cierra y abre la terminal para que lo encuentre
primeros comandos
$ pwd            # ¿en qué carpeta estoy?
$ ls             # ¿qué hay aquí?
$ cd proyectos   # entrar en una carpeta
$ cd ..          # subir un nivel
$ code .         # abrir esta carpeta en VS Code

> winget install -e --id Git.Git
$ brew install git
Paso 1 · primero, VS Code

Visual Studio Code

Windows

winget install -e --id
  Microsoft.VisualStudioCode

macOS

brew install --cask
  visual-studio-code

Muévelo a Aplicaciones y activa el comando code

Linux

sudo apt install ./code_*.deb

Paquete .deb de la web oficial

Extensiones: Python, Jupyter y WSL (Windows).  ·  No es lo mismo que Visual Studio, que es otro producto.

Paso 2 · Git

¿Qué es Git?

Un sistema de control de versiones: guarda la historia completa de un proyecto.

  • Volver atrás a cualquier versión
  • Saber qué cambió, cuándo y por qué
  • Probar ideas en ramas sin romper nada
  • Trabajar en equipo sobre el mismo código
sin control de versiones
analisis.py
analisis_v2.py
analisis_v2_bueno.py
analisis_FINAL.py
analisis_FINAL_ahora_si.py
con Git
analisis.py   # un archivo y todo su historial
$ git log --oneline
a1f3c9e Corrige el cálculo de la media
7b2d410 Añade gráfico de ventas
Paso 2 · Git

Git y GitHub no son lo mismo

Git

Un programa que funciona en tu ordenador, incluso sin internet

GitHub

Una web que aloja repositorios de Git para compartirlos y colaborar

Tu carpetaarchivos
Preparadosstaging
Historial localcommits
GitHubremoto
git add →
git commit →
git push →
← git pull: traer los cambios de GitHub
Paso 2 · Git

Instalar y configurar

SistemaInstalación
Windowswinget install -e --id Git.Git
macOSxcode-select --install o brew install git
Linuxsudo apt install git

En Windows, instala VS Code antes: el instalador de Git lo detecta como editor.

una sola vez por ordenador
$ git --version
$ git config --global user.name "Nombre Apellido"
$ git config --global user.email "tu@correo.com"
$ git config --global init.defaultBranch main
$ git config --global core.editor "code --wait"

Usa el mismo correo que en tu cuenta de GitHub.

Paso 3 · GitHub

Conectar Git con GitHub

1

Crea tu cuenta

  • Usuario profesional
  • Verificación en dos pasos
  • GitHub Education con tu correo @uma.es
A

HTTPS + GitHub CLI

Recomendada. Inicias sesión en el navegador y Git queda configurado.

gh auth login
gh auth status
B

Claves SSH

Generas una clave y subes la parte pública a GitHub.

ssh-keygen -t ed25519
ssh -T git@github.com

GitHub no acepta tu contraseña en git push: usa la opción A o la B.

Comprobación

Prueba de principio a fin

  • Crea en GitHub un repositorio privado prueba-git con README
  • Clónalo, edita el README en VS Code y súbelo
  • Si el push no pide contraseña y el cambio aparece en GitHub, todo está listo
terminal
$ git clone https://github.com/TU_USUARIO/prueba-git.git
$ cd prueba-git
$ code .
# edita README.md y guarda
$ git add README.md
$ git commit -m "Añade mi nombre al README"
$ git push
Manos a la obra

¿Preguntas?

La guía completa, con los problemas frecuentes y una checklist, está en el repositorio del curso:

github.com/sandrohr95/laboratorio-mbd-2026