Apprendre Git

Git simulation

Principles essentielles

Visualier la mindmap

Utilisation de base

Config

git config --global user.name "Rong Zhou"
git config --global user.email "ron@ronzz.org"
git config user.<valeur>
git config credential.helper 'cache --timeout 36000' # --global

Rendre .git fichiers visible en VSCode:
CTRL+, > >Exclude > x**/.git

Visioner l'histoire de révision

git log --graph --oneline --decorate {branch-name : default HEAD }# --all --color

Pour une branche remote :

git fetch origin
# Voir les commits d'une branche distante origin/feature-x
git log --graph --oneline --decorate --color origin/feature-x

commit, branches, et rebase

git commit
git branch {branch_name}
git switch {branch_name/commit_name/relative_commit_reference} # e.g., {main/fec0/main^^|main~2 # La branche sera crée si elle n'existe pas encore  --orphan : sans historique

git merge {branch_name} # Integrates changes from another branch into your current branch. The commit graph preserves the fact that two lines of development existed.

git rebase {target_parent_branch_name} # -i pour interactive # Re‑applies commits from your current branch on top of another branch for a linear history.

rollback

git branch -f {branch/HEAD to be deplaced} {destination-branch/HEAD} # changer seulement le postionnement des branches et HEAD sans bouger les commits
git reset HEAD~1 # annule dernier commit (LOCAL seulement)
git revert HEAD # faire un nouveau commit qui en effet annule le dernier commit
# remarquez qu'en `reset` on specifie l'état cible où en `revert` on specifie le commit à annuler 

Dupliquer un fichier/dossier d'une branche à une autre

git restore --source main resources/

Cherry Pick

git cherry-pick {commit_name}
git commit --amend

Tag

git tag {tag_name} {target_commit : default HEAD}
git describe {commit}

Stash

git stash push -m "Message descriptif" # -k Stasher uniquement les fichiers suivis -u include-untracked
git stash list
git stash show -p stash@{0}
git stash pop stash@{0}
git stash apply stash@{0} # Garde le stash après l'application. Utile pour l'appliquer sur différentes branches
git stash drop stash@{0} # Supprimer un stash spécifique
git stash clear # Supprimer tous (DANGER !)

Collaboration en ligne

Init : clone

git clone <URL>
git clone --single-branch --branch <nom-de-la-branche> <url>

.gitignore : à placer à la racine du dépôt Git

passwords.txt
*.txt

rm -rf .git
git init
git status # -s: montrer moin des détails
git add . # tout les modifications dois sont validé par `add` avant `commit`.*
git add <filename>*
git diff # --staged
git commit -m "message" -a # -a = add .

• . inclut tous les fichiers dans les SOUS-DOSSIERs de répertoire actuel du terminal. Exécutez git add . à la racine du répertoire de dépôt pour valider des changements sur tous les fichiers.

Annuler les modifications :

git rm --cached  {files*} # Cesser de traquer des fichiers
git reset --soft HEAD~1 # roll-back dernier commit. --soft: ne changera pas les fichiers dans votre répertoire de travail, et les commits annulés sont conservé dans l'index comme 'staged', prêt pour refaire.

Repo à distance

git remote add origin <URL>
git branch -M main
git pull origin main # = fetch + merge. --rebase  = fetch + rebase
git push -u origin main --force-with-lease # force-with-lease prévien l'écrasement accidentel des changements effectuer par les autres développeurs depuis votre dernier `pull`
git push --set-upstream origin bugfix1 # pousser nouvelle branche

Annuler les modifications

git revert HEAD~1
git restore --source=origin/main --worktree file.txt # restaure file.txt depuis origin/main dans le répertoire de travail 

Revenir à l'état de distant (écraser des changements locals)

git fetch origin
git reset --hard origin/main

Pour restaurer uniquement certains fichiers à partir de la branche distante :

git restore --source=origin/main --staged --worktree chemin/vers/fichier1 chemin/vers/fichier2

Opérations courant

• Fusionner deux dépôts

Problèmes connu

Dossier nommé comme fichiers ❌

reveal.js/reveal.js ❌

git l'interpreter la premier reveal.js comme fichier Javascript et ignorer la actuel javascript.

Inclusion des .git dossier (potentiellement invisible*) en sou-dossiers ❌

*: nombreuses OS n'afficher pas les dossier /\..*/ par défaut

plutôt:

# suivres les changes de ce sous-dossier .git 
git submodule add <url_du_dépôt*> assets/js/reveal-js/ # Dépôt distant, comme Github, ou locale, en un autre dossier

ou:

# ne suivres pas les changes
rm -rf assets/js/reveal-js/.git

pdfs, tomls ignoré par defaut ❌

find . -name "*.toml" -o -name "*.pdf" -exec git add -f {} +

Please enter a commit message ❌

# Merge branch 'repair2' of https://gitlab.com/ronzz-public/CDN into repair2 
# Please enter a commit message to explain why this merge is necessary, 
# especially if it merges an updated upstream into a topic branch. 
# Lines starting with '#' will be ignored, and an empty message aborts # the commit. 
~

Naviguez avec les flèches sur votre clavier jusqu'à la fin des lignes de commentaires précédées par #, puis taper o pour insérer une nouvelle ligne. Entrez un message, puis tape esc et :wq pour enregistrer et fermer.

Github

gh auth login
gh auth status

# Create a repository interactively
gh repo create

Gitlab

L'utilisation de Gitlab VScode extension est conseillé.

Diagnostiques

git fsck --full