.gitignore Sintaks: bin vs bin / vs. bin / * vs. bin / **

Apa perbedaan antara menambahkan bin, bin/, bin/*dan bin/**dalam file Gitignore saya? Saya telah menggunakan bin/, tetapi melihat file .gitignore lainnya (dalam file gerhana bintang ganda dan bintang tunggal bahkan digunakan bersamaan seperti ini: ada apa dengan itu?) Saya melihat bahwa dua pola pertama juga banyak digunakan. Bisakah seseorang menjelaskan perbedaan antara ketiganya?tmp/**/*

bincocok dengan file atau direktori apa pun yang bernama 'bin'.

bin/cocok dengan semua direktori bernama 'bin', yang artinya semua isinya karena Git tidak melacak direktori saja.

bin/*cocok dengan semua file dan direktori secara langsung di sembarang bin/. Hal ini mencegah Git secara otomatis menemukan file apa pun dalam subdirektorinya, tetapi jika, misalnya bin/foosubdirektori dibuat, aturan ini tidak akan cocok foodengan kontennya.

bin/**cocok dengan semua file dan direktori dalam bin/direktori manapun dan semua subdirektorinya.

Kata "any" sangat penting di sini karena aturan tidak berhubungan dengan root repositori dan berlaku di mana saja di pohon sistem file. Anda harus memulai aturan dengan /(atau !/untuk membatalkan pengabaian) yang berarti root repositori, bukan root sistem, untuk mencocokkan hanya yang dimaksudkan.

PERINGATAN: Anda harus tidak pernah menggunakan aturan seperti dir/*, /dir/**, dll saja kecuali Anda juga un-mengabaikan sesuatu yang ada di dalam direktori tersebut . Hilangkan tanda bintang atau Anda dapat kehilangan banyak data secara permanen dari pemanggilan tertentu git gc, git stashdan banyak lagi.

Saya tidak begitu tahu apa tmp/**/*yang harus saya lakukan. Awalnya saya mengira ini dapat digunakan untuk mencocokkan file di sub-direktori tmp/tetapi bukan file yang langsung ada di dalamnya tmp/. Tetapi tes sederhana tampaknya menunjukkan bahwa ini mengabaikan semua file di tmp/.

bindan bin/hanya berbeda dalam hal ini yang terakhir hanya akan cocok dengan direktori.

bin/**/*sama dengan bin/**(tampaknya sejak 1.8.2, menurut jawaban @ VonC).

Yang rumit, bahwa saya hanya menghabiskan satu jam atau lebih merobek rambut saya, adalah itu bin/dan bin/**tidak persis sama! Karena sebelumnya mengabaikan direktori secara keseluruhan, dan yang terakhir mengabaikan setiap file di dalamnya, dan git di hampir semua kasus tidak peduli dengan direktori, biasanya tidak ada perbedaan. Namun, jika Anda mencoba menggunakan !untuk tidak mengabaikan sub jalur, Anda akan mendapati bahwa git (ahem) mengabaikannya jika Anda mengabaikan direktori induk! (sekali lagi, bukan isi direktori)

Ini paling jelas dengan contoh, jadi untuk repositori yang baru diinit, atur begitu:

$ cat .gitignore
ignored-file
or-dir
dir-only/
!dir-only/cant-reinclude
dir-contents/**
!dir-contents/can-reinclude

$ mkdir or-dir dir-only dir-contents

$ touch file ignored-file or-dir/ignored-file dir-only/cant-reinclude dir-contents/can-reinclude

Ada file yang tidak terlacak berikut:

$ git ls-files --other
.gitignore
dir-contents/can-reinclude
dir-only/cant-reinclude
file
ignored-file
or-dir/ignored-file

Tetapi Anda dapat melihat file-file berikut tidak diabaikan:

$ git ls-files --other --exclude-standard
.gitignore
dir-contents/can-reinclude
file

Dan jika Anda mencoba menambahkan, Anda mendapatkan:

$ git add dir-only/cant-reinclude
The following paths are ignored by one of your .gitignore files:
dir-only/cant-reinclude
Use -f if you really want to add them.
fatal: no files added

Saya menganggap perilaku ini sebagai bug. (Ini semua aktif git version 1.8.4.msysgit.0)

Perhatikan bahwa, secara tegas, git tidak melacak direktori, hanya file. Oleh karena itu, tidak mungkin untuk menambahkan direktori, hanya isinya .

.gitignoreNamun dalam konteksnya , git berpura-pura memahami direktori hanya untuk alasan itu

Tidak mungkin untuk memasukkan kembali file jika direktori induk dari file itu dikecualikan.
https://git-scm.com/docs/gitignore#_pattern_format

Apa artinya ini untuk pola pengecualian? Mari kita bahas secara detail:

bin

Ini mengabaikan

• file bernama bin.
• isi folder bernama bin

Anda dapat memasukkan binfile dan folder yang diabaikan ke dalam daftar putih dengan menambahkan !entri berikutnya , tetapi Anda tidak dapat memasukkan konten folder bernamabin

bin

!bin/file_in_bin # has no effect, since bin/ is blacklisted!
!bin/* # has no effect, since bin/ is blacklisted!
!file_in_bin # has no effect, since bin/ is blacklisted!

!bin # this works

bin/

Sama seperti di atas, hanya saja tidak cocok dengan file bernama bin. Menambahkan sebuah trailing /memberitahu git untuk mencocokkan direktori saja.

bin/*

Ini mengabaikan

• file yang terdapat dalam folder bernamabin
• isi subfolder langsung dari folder bernama bin

bin/*  # blacklists bin/file_in_bin and bin/subfolder/

!bin/subfolder/file_in_sub # has no effect, since bin/subfolder is blacklisted!
!bin # whitelists files named bin/bin, since bin/ itself is not blacklisted
!bin/ # has no effect, since bin/ itself is not blacklisted


!bin/file_in_bin # works since bin/ itself is not blacklisted
!file_in_bin # works too
!bin/subfolder # works (so implicitly whitelists bin/subfolder/file_in_sub)
!bin/subfolder/ # works just as well
!bin/* # works for file_in_bin and subfolder/

bin/**

Ini mengabaikan

• Isi dari bin
• konten subfolder (tingkat penumpukan apa pun) di dalamnya bin

bin/**  # blacklists bin/file_in_bin and
        # bin/subfolder/ and bin/subfolder/file_in_sub and
        # bin/subfolder/2/ and bin/subfolder/2/file_in_sub_2

!bin/subfolder/file_in_sub # has no effect, since bin/subfolder is blacklisted
!bin/subfolder/2/ # has no effect, since bin/subfolder is blacklisted
!bin/subfolder/2/file_in_sub_2 # has no effect, since bin/subfolder is blacklisted

!bin/subfolder # works only in combinations with other whitelist entries,
               # since all contents of subfolder are blacklisted (1)

!bin/file_in_bin # works since bin itself is not blacklisted
!bin/* # works for file_in_bin and subfolder; see (1)

Saya baru saja membuat repo baru dan mencoba beberapa hal. Ini hasil saya:

HASIL BARU

git versi 2.10.1.windows.1

1. Inisialisasi repo yang hampir kosong. Hanya file README
2. Isi bindirektori sedalam beberapa lapisan
   • bin.txt
   • Test.txt
   • bin/a/b/bin.txt
   • bin/a/b/Test.txt
   • bin/a/bin/bin.txt
   • bin/a/bin/Test.txt
   • bin/a/bin.txt
   • bin/a/Test.txt
   • bin/bin.txt
   • bin/Test.txt
3. Tambahkan binke gitignore: Hasil
   • Semua yang ada di bawah bindirektori (dan lebih dalam) sekarang diabaikan
   • Level root tidak diabaikan (/bin.txt dan /Test.txt masih ditampilkan)
4. Edit binke bin/di gitignore: Hasil
   • Tidak ada perubahan
5. Edit bin/kebin/*
   • Tidak ada perubahan
6. Edit bin/*kebin/**
   • Tidak ada perubahan
7. Edit bin/**kebin/**/
   • bin/bin.txtdan bin/Test.txttidak lagi diabaikan
8. Edit bin/**/kebin/**/*
   • bin/bin.txtdan bin/Test.txtkembali diabaikan

HASIL LAMA

versi git: 2.7.0.windows.1

1. Inisialisasi repo yang hampir kosong. Hanya file README
2. Isi bindirektori sedalam beberapa lapisan
   • bin/a/b/Test.txt
   • bin/a/bin/Test.txt
   • bin/a/Test.txt
   • bin/Test.txt
3. Tambahkan binke gitignore: Hasil
   • Semua yang ada di bawah bindirektori (dan lebih dalam) sekarang diabaikan
4. Edit binke bin/di gitignore: Hasil
   • Segala sesuatu di bawah bindirektori (dan lebih dalam) masih diabaikan (tidak ada perubahan)
5. Edit bin/kebin/*
   • Segala sesuatu di bawah bindirektori (dan lebih dalam) masih diabaikan (tidak ada perubahan)
6. Edit bin/*kebin/**
   • Segala sesuatu di bawah bindirektori (dan lebih dalam) masih diabaikan (tidak ada perubahan)
7. Edit bin/**kebin/**/
   • bin/Test.txt tidak lagi diabaikan
8. Edit bin/**/kebin/**/*
   • Segala sesuatu di bawah bindirektori (dan lebih dalam) akan diabaikan lagi

Perhatikan bahwa ' **', jika digabungkan dengan sub-direktori ( **/bar), pasti sudah berubah dari perilaku defaultnya, karena catatan rilis untuk git1.8.2 sekarang menyebutkan:

Pola dalam .gitignoredan .gitattributesfile dapat memiliki **/, sebagai pola yang cocok dengan 0 atau lebih tingkat subdirektori.

Misalnya " foo/**/bar" cocok " bar" dalam " foo" itu sendiri atau dalam subdirektori " foo".

Aturan yang harus diingat (dan yang membantu memahami perbedaan maksud di balik sintaks tersebut) adalah:

Tidak mungkin untuk memasukkan kembali file jika direktori induk dari file itu dikecualikan.

Biasanya, jika Anda ingin mengecualikan file dari subfolder dari folder abaikan f, Anda akan melakukan:

f/**
!f/**/
!f/a/sub/folder/someFile.txt

Itu adalah:

• Jika aturan pertama adalah f/, folder f/akan diabaikan dan aturan di bawah fini tidak akan menjadi masalah.
• f/**mencapai hal yang sama f/, tetapi abaikan semua sub-elemen (file dan subfolder).
  Yang memberikan Anda kesempatan untuk daftar putih (mengecualikan dari gitignore) subfolder: !f/**/.
• Karena semua fsubfolder tidak diabaikan, Anda bisa menambahkan aturan untuk mengecualikan file ( !f/a/sub/folder/someFile.txt)

Ada perbedaan lain antara bin/*dan bin/.

bin/cocok foo/bin/test.txt(seperti yang diharapkan), tetapi bin/*tidak, yang tampaknya aneh, tetapi ini didokumentasikan: https://git-scm.com/docs/gitignore

"Documentation / *. Html" cocok dengan "Documentation / git.html" tetapi tidak dengan "Documentation / ppc / ppc.html" atau "tools / perf / Documentation / perf.html".

Alasannya tampaknya karena aturan ini:

• Jika pola diakhiri dengan garis miring, itu dihapus untuk tujuan deskripsi berikut ...

• Jika pola tidak mengandung garis miring /, Git akan memperlakukannya sebagai pola shell glob dan memeriksa kecocokan dengan nama path yang berhubungan dengan lokasi file .gitignore…

• Jika tidak, Git akan memperlakukan pola sebagai shell glob yang cocok untuk dikonsumsi oleh fnmatch (3) dengan flag FNM_PATHNAME…

Jadi jika polanya diakhiri dengan garis miring, garis miring tersebut akan dihapus dan diperlakukan sebagai pola shell glob, dalam hal ini bincocok foo/bin/test.txt. Jika diakhiri dengan /*, garis miring tidak dihapus dan diteruskan ke fnmatch, yang tidak cocok di subdirektori.

Namun, hal yang sama tidak berlaku untuk foo/bin/dan foo/bin/*, karena bahkan setelah menghapus garis miring dari foo/bin/, itu masih berisi garis miring, jadi itu diperlakukan sebagai pola fnmatch, bukan bola. Yaitu tidak akan cocokbar/foo/bin/test.txt