Guía práctica de Git
Branches cortas · Integración frecuente · Releases controladas
La idea en 30 segundos
TBD mantiene
maincomo línea de integración, con entregas pequeñas y branches cortas. CI (Integración Continua) compila, prueba y analiza el código en cada push o PR/MR. Las release branches son opcionales y solo estabilizan versiones mientrasmainavanza.
Este es el flujo principal cuando el proyecto ya existe en un servidor Git. La URL puede usar SSH o HTTPS.
git clone <URL-DEL-REMOTO>
cd nombre-repo
git switch main
git pull --ff-only origin mainorigin es el nombre convencional del remoto. --ff-only evita un merge automático y falla si hay divergencia.
Usa una branch para un cambio pequeño que necesite revisión o CI antes de llegar a la trunk. Termina en horas o pocos días.
Nombra la branch según el cambio: feat/, fix/, docs/, test/, refactor/, build/ o chore/. El glosario explica estos prefijos.
git switch -c feat/lectura-sensor
git status
git diff -- src/sensor.c include/sensor.h
git add src/sensor.c include/sensor.h
git rm src/obsolete.c
git commit -m "feat: lee sensor por I2C"Añade archivos explícitamente; git rm elimina el archivo del working tree y del índice.
Para corregir el último commit antes de publicar:
git add include/sensor.h
git commit --amend --no-editBuena práctica
Aunque el trabajo esté incompleto, haz un commit al final del día para no perder progreso. Si ese commit todavía no fue publicado, continúa al día siguiente y usa
--amendpara actualizarlo; esto cambia su SHA. Después de publicar, prefiere un commit nuevo antes que reescribir historial compartido.
Publica la branch para abrir el PR/MR. La integración en main ocurre después, en la plataforma remota:
git push -u origin feat/lectura-sensorPR (GitHub) y MR (GitLab) son solicitudes de revisión en la plataforma; abrir o aprobar no integra el código. Tras CI y la aprobación requerida, haz el merge. Son opcionales en TBD: mantén branches y revisiones breves.
GitHub · Instalar gh
gh pr create --base main --fill
# después de aprobar
gh pr merge --squash --delete-branchGitLab · Instalar glab
glab mr create --fill
# después de aprobar
glab mr merge --squash --remove-source-branchCodeberg / Gitea · Instalar tea
tea pulls create \
--base main \
--head feat/ejemplo \
--title "feat: agrega ejemplo"
# después de aprobar, haz el merge en la interfaz webMerge local (integra en este clon, sin PR/MR):
git switch main
git merge --no-ff feat/ejemploSolo cambia el repositorio local; el servidor remoto no recibe este merge.
Actualizar × integrar
--ff-only A---B---S main --no-ff A---B---------M main \ / C-----D feat/ejemplo
pull --ff-onlyactualizamain;Mmarca el merge--no-ff.
Merge local: git branch -d. Tras un squash remoto, confirma el PR/MR y usa git branch -D. La plataforma elimina la branch remota.
git switch main
git pull --ff-only
git branch -d feat/lectura-sensorMarcio
Bulla
From beginner to beginner
Una release branch es opcional: créala cerca del lanzamiento, solo para estabilizar. La trunk continúa recibiendo features; la release no recibe funcionalidad nueva.
git switch main
git pull --ff-only origin main
git switch -c release/1.0
git push -u origin release/1.0
git tag -a v1.0.0 -m "Release 1.0.0"
git push origin v1.0.0El tag debe apuntar al commit exacto aprobado. Para una actualización 1.0.1 nacida en la trunk, localiza el SHA, lleva la corrección a la release y crea el tag.
git switch main
git log --oneline --decorate -10
# corrige, prueba y crea el commit
git switch release/1.0
git cherry-pick <SHA>
git tag -a v1.0.1 -m "Release 1.0.1"
git push origin release/1.0 v1.0.1Propagación controlada
cherry-pickcrea otro commit, normalmente con otro SHA. En un conflicto, resuelve, usagit addygit cherry-pick --continue; cancela congit cherry-pick --abort.
Usa el log para localizar el commit aprobado, entender la topología y comparar trunk con release.
git log --oneline --decorate --graph --all
git show <SHA>
git log main..release/1.0
git diff main..release/1.0Para recuperar un commit antiguo sin reescribir la trunk compartida, localízalo y crea una branch de recuperación.
git reflog
git switch -c recovery/old-state <SHA>
git restore --source=<SHA> -- src/sensor.c
git diff --stat
git add src/sensor.c
git commit -m "fix: restaura estado estable"
git push -u origin recovery/old-stateSi quieres deshacer un commit ya publicado, prefiere revert:
git switch main
git pull --ff-only origin main
git revert <SHA>
git push origin mainCuidado
git revertcrea un commit nuevo y conserva el historial.git reset --hardpuede descartar cambios locales y no debe reescribir historial compartido. Conserva el trabajo congit stash push -m "wip".
Usa este flujo cuando el proyecto todavía no es un repositorio Git. Después, publícalo en el remoto.
git init
git switch -c main
git add README.md
git commit -m "chore: inicia repositorio"
git remote add origin <URL-DEL-REMOTO>
git push -u origin mainPrefijos (branch: / · commit: :): feat funcionalidad · fix corrección · docs documentación · test pruebas · refactor estructura sin cambiar el comportamiento · build build/dependencias · chore mantenimiento y organización.
git clone — copia un repositorio remoto.
git init — inicia un repositorio Git local.
git remote — gestiona las URL de los repositorios remotos.
git switch — cambia de branch; -c crea una nueva.
git status — muestra el estado de los archivos.
git diff — compara cambios no confirmados.
git add — prepara cambios; no crea commit.
git rm — elimina y prepara la eliminación.
git merge — integra el historial de otra branch.
git commit — guarda en el historial lo preparado.
git log — lista commits; --oneline resume.
git show — muestra un commit y sus cambios.
git pull — busca e integra actualizaciones remotas.
git push — publica commits locales en el remoto.
git fetch — busca referencias sin cambiar tu branch.
git tag — marca un commit con una versión.
git cherry-pick — copia un commit a otra branch.
git revert / restore / stash — deshace, recupera o guarda.
Marcio
Bulla
From beginner to beginner
Versión para imprimir: descargar PDF A4 · Português (PDF) · English (PDF)
Fuentes oficiales: Trunk-Based Development: branches de corta duración · PR y revisión continua · git-merge · git-pull · git-rebase · git-push · git-revert