Παράβλεψη αρχείων και καταλόγων στο git (.gitignore)

Συχνά, όταν εργάζεστε σε ένα έργο που χρησιμοποιεί το Git, θα θέλετε να εξαιρέσετε συγκεκριμένα αρχεία ή καταλόγους από το να πιέσετε στο απομακρυσμένο αποθετήριο.

Το αρχείο .gitignore καθορίζει ποια μη κρυπτογραφημένα αρχεία πρέπει να αγνοήσει το Git.

Ποια αρχεία πρέπει να αγνοηθούν;

Τα παραβιασμένα αρχεία είναι συνήθως αρχεία ειδικά για την πλατφόρμα ή αρχεία που δημιουργούνται αυτόματα από τα συστήματα δημιουργίας. Μερικά κοινά παραδείγματα περιλαμβάνουν:

• Αρχεία χρόνου εκτέλεσης, όπως αρχεία καταγραφής, κλειδώματος, προσωρινής αποθήκευσης ή προσωρινά αρχεία. Τα αρχεία με ευαίσθητες πληροφορίες, όπως κωδικούς πρόσβασης ή κλειδιά API.Κατασκευασμένος κώδικας, όπως .class ή .o καταλόγους ανεξαρτησίας, όπως /vendor ή /node_modules , όπως /public , /out , ή /dist . Αρχεία συστήματος όπως το .DS_Store ή το Thumbs.db IDE ή τα αρχεία ρυθμίσεων του επεξεργαστή κειμένου.

.gitignore

Ένα τοπικό αρχείο .gitignore τοποθετείται συνήθως στον ριζικό κατάλογο του αποθετηρίου. Ωστόσο, μπορείτε να δημιουργήσετε πολλαπλά αρχεία .gitignore σε διάφορους υποκαταλόγους στο χώρο αποθήκευσής σας. Τα μοτίβα στα αρχεία .gitignore αντιστοιχίζονται σε σχέση με τον κατάλογο όπου βρίσκεται το αρχείο.

Τα μοτίβα που ορίζονται στα αρχεία που βρίσκονται σε καταλόγους χαμηλότερου επιπέδου (δευτερεύοντες κατάλογοι) έχουν προτεραιότητα σε σχέση με εκείνους στους καταλόγους υψηλότερου επιπέδου.

Τα .gitignore αρχεία .gitignore μοιράζονται με άλλους προγραμματιστές και πρέπει να περιέχουν πρότυπα χρήσιμα για όλους τους άλλους χρήστες του .gitignore αποθήκευσης.

Προσωπικοί κανόνες παράβλεψης

Τα πρότυπα που είναι ειδικά για τον τοπικό χώρο αποθήκευσης και δεν πρέπει να διανεμηθούν σε άλλα αποθετήρια, θα πρέπει να ορίζονται στο .git/info/exclude .

Για παράδειγμα, μπορείτε να χρησιμοποιήσετε αυτό το αρχείο για να αγνοήσετε τα αρχεία που δημιουργούνται από τα προσωπικά σας εργαλεία του έργου.

Global .gitignore

Το Git σας επιτρέπει επίσης να δημιουργήσετε ένα παγκόσμιο αρχείο .gitignore , όπου μπορείτε να ορίσετε κανόνες .gitignore για κάθε αποθήκη Git στο τοπικό σας σύστημα.

Το αρχείο μπορεί να ονομάζεται οτιδήποτε θέλετε και να αποθηκεύεται σε οποιαδήποτε θέση. Το πιο συνηθισμένο μέρος για να διατηρήσετε αυτό το αρχείο είναι ο αρχικός κατάλογος. Θα χρειαστεί να δημιουργήσετε με μη αυτόματο τρόπο το αρχείο και να διαμορφώσετε το Git για να το χρησιμοποιήσετε.

Για παράδειγμα, για να ορίσετε το ~/.gitignore_global ως το παγκόσμιο αρχείο ~/.gitignore_global Git, θα κάνατε τα εξής:

1. Δημιουργήστε το αρχείο:

   touch ~/.gitignore_global

   Προσθέστε το αρχείο στη διαμόρφωση Git:

   git config --global core.excludesfile ~/.gitignore_global

   Ανοίξτε το αρχείο με τον επεξεργαστή κειμένου και προσθέστε τους κανόνες σε αυτό.

Οι γενικοί κανόνες είναι ιδιαίτερα χρήσιμοι για την αφαίρεση συγκεκριμένων αρχείων που δεν θέλετε να δεσμεύσετε ποτέ, όπως αρχεία με ευαίσθητες πληροφορίες ή συντάξιμα εκτελέσιμα αρχεία.

Αγνοώντας ένα προηγουμένως δεσμευμένο αρχείο

Τα αρχεία του αντιγράφου εργασίας σας μπορούν είτε να παρακολουθούνται είτε να μην αναπαράγονται.

Για να αγνοήσετε ένα αρχείο που έχει προηγουμένως δεσμευτεί, θα χρειαστεί να διαγράψετε και να αφαιρέσετε το αρχείο από το ευρετήριο και στη συνέχεια να προσθέσετε έναν κανόνα για το αρχείο στο .gitignore :

git rm --cached filename

Η επιλογή --cached λέει στο git να μην διαγράψει το αρχείο από το δέντρο εργασίας αλλά μόνο να το αφαιρέσει από το ευρετήριο.

Για να καταργήσετε μια αναδρομική καταχώρηση ενός καταλόγου, χρησιμοποιήστε την επιλογή -r :

git rm --cached filename

Κατά την αναδρομική διαγραφή αρχείων, χρησιμοποιήστε την επιλογή -n που θα εκτελέσει μια "ξηρή εκτέλεση" και θα σας δείξει ποια αρχεία θα διαγραφούν:

git rm -r -n directory

Debugging .gitignore Αρχείο

Μερικές φορές μπορεί να είναι δύσκολο να καθορίσετε γιατί αγνοείται ένα συγκεκριμένο αρχείο, ειδικά όταν χρησιμοποιείτε πολλά αρχεία .gitignore ή περίπλοκα μοτίβα. Αυτό είναι όπου η εντολή git check-ignore με την επιλογή -v , η οποία λέει στο git να εμφανίσει λεπτομέρειες σχετικά με το μοτίβο που ταιριάζει, είναι χρήσιμη.

Για παράδειγμα, για να ελέγξετε γιατί www/yarn.lock αρχείο www/yarn.lock θα εκτελέσετε:

git check-ignore -v www/yarn.lock

Η έξοδος εμφανίζει τη διαδρομή προς το αρχείο gitignore , τον αριθμό της γραμμής αντιστοίχισης και το πραγματικό μοτίβο.

www/.gitignore:31:/yarn.lock www/yarn.lock

Η εντολή δέχεται επίσης περισσότερα από ένα ονόματα αρχείων ως επιχειρήματα και το αρχείο δεν χρειάζεται να υπάρχει στο δέντρο εργασίας σας.

Εμφάνιση όλων των παραβιασμένων αρχείων

Η εντολή git status με την επιλογή --ignored εμφανίζει μια λίστα όλων των αρχείων που αγνοήθηκαν:

git status --ignored

συμπέρασμα

Το αρχείο .gitignore σάς επιτρέπει να εξαιρέσετε τα αρχεία από το να ελέγχονται στο αποθετήριο. Το αρχείο περιέχει μοτίβα συσκότισης που περιγράφουν τα αρχεία και τους καταλόγους που πρέπει να αγνοηθούν.

Το gitignore.io είναι μια ηλεκτρονική υπηρεσία που σας επιτρέπει να δημιουργείτε αρχεία .gitignore για το λειτουργικό σας σύστημα, τη γλώσσα προγραμματισμού ή το IDE.