Este documento reúne los comandos de Git más útiles para el flujo de trabajo de este proyecto. La idea es usarlo como referencia rápida mientras desarrollas cada feature sin tener que memorizarlo todo desde el principio.
main: rama estable y publicabledev: rama de integraciónfeature/*: rama de trabajo para una tarea concreta
Recomendación práctica:
- crear cada rama feature solo cuando realmente vayas a empezar esa feature
- trabajar una sola feature cada vez
- validar y cerrar la feature antes de abrir la siguiente
Ver rama actual y estado resumido:
git status --short --branchVer ramas locales:
git branch --listVer remoto configurado:
git remote -vVer historial resumido:
git log --oneline --graph --decorate --allAñadir archivos concretos:
git add README.md
git add docs/evidencias.mdAñadir archivos modificados y eliminados ya seguidos por Git:
git add -uAñadir todo:
git add .Crear un commit:
git commit -m "feat: descripcion breve del cambio"Crear una rama sin cambiarte a ella:
git branch feature/nombre-de-la-featureCrear una rama y cambiarte en el mismo paso:
git switch -c feature/nombre-de-la-featureCambiar a una rama existente:
git switch dev
git switch main
git switch feature/layout-basePartiendo de dev actualizado:
git switch dev
git status --short --branch
git switch -c feature/layout-baseTrabajas, guardas cambios y haces commit:
git add .
git commit -m "feat: crear layout base del editor y preview"Subes la rama al remoto:
git push -u origin feature/layout-baseVolver a dev:
git switch devHacer merge de la feature:
git merge feature/layout-baseSubir dev:
git push origin devSubir la rama actual y dejar seguimiento:
git push -u origin nombre-de-la-ramaEjemplos:
git push -u origin dev
git push -u origin feature/project-setupVer cambios sin preparar:
git diffVer cambios ya preparados con git add:
git diff --cachedVer diferencias entre ramas:
git diff dev..feature/layout-baseQuitar un archivo del área de staging:
git restore --staged README.mdRecuperar un archivo modificado al último commit:
git restore README.mdImportante:
- usa estos comandos con cuidado
- no los uses si no tienes claro si quieres conservar tus cambios
Ver en qué ramas está un commit o rama:
git branch --containsEliminar una rama local ya fusionada:
git branch -d feature/layout-baseEliminar una rama remota:
git push origin --delete feature/layout-baseEjemplos útiles para este proyecto:
chore: preparar estructura inicial del proyectodocs: añadir hoja de ruta del proyectofeat: crear layout base del editorfeat: implementar persistencia en localStoragefix: corregir render de la previewstyle: ajustar estilos responsive
Como este proyecto también es de práctica, lo más recomendable es no crear todas las ramas de golpe. Es mejor crear cada feature/* cuando vayas a empezar esa parte del roadmap. Así reduces confusión, entiendes mejor el flujo y practicas Git de forma más realista.