Panduan lengkap sintaks pola .gitignore

Setiap baris .gitignore adalah satu pola. Sintaksnya mirip glob di shell, tetapi maknanya sangat berubah tergantung letak garis miring dan letak **. Isi di bawah mengikuti dokumentasi resmi git, gitignore(5), dan contohnya diperiksa langsung dengan git 2.50.

Baris kosong, komentar, dan escape

• Baris kosong tidak cocok dengan apa pun. Gunakan sebagai pemisah agar mudah dibaca.
• Baris yang diawali # adalah komentar. Untuk mengabaikan file yang namanya diawali #, tambahkan garis miring terbalik seperti \#.
• Spasi di akhir baris diabaikan. Jika butuh nama file yang diakhiri spasi, lindungi spasinya dengan garis miring terbalik seperti foo\ . Spasi di awal baris tetap menjadi bagian pola.
• Baris yang diawali ! adalah pola negasi. Untuk file yang namanya diawali !, tulis \!important.txt.

Spasi di akhir baris tidak terlihat dan sering menjadi sumber kesalahan. Jika aturan tidak berlaku, aktifkan tampilan spasi di editor. Ingat juga bahwa hanya karakter spasi yang dihapus; tab tidak.

Garis miring di akhir: hanya direktori

Jika pola diakhiri /, pola itu hanya cocok dengan direktori. build/ mengabaikan direktori build beserta seluruh isinya, tetapi tidak mengabaikan file bernama build. Sebaliknya, build tanpa garis miring cocok dengan file maupun direktori bernama itu.

Garis miring menjangkarkan posisi

Jika sisa pola, di luar garis miring akhir, berisi / di awal atau di tengah, pola hanya cocok dengan jalur relatif terhadap direktori tempat .gitignore berada. Ini sering disebut penjangkaran (anchoring). Tanpa /, git mencari entri bernama sama di kedalaman mana pun di bawah .gitignore.

Baris ketiga paling membingungkan. logs/debug.log punya garis miring di tengah, jadi dijangkarkan ke root dan sama artinya dengan menambahkan / di depan. Untuk menangkap logs/debug.log di kedalaman mana pun, gunakan **/logs/debug.log.

Wildcard: *, ?, [ ]

• * cocok dengan string apa pun kecuali / (termasuk string kosong). *.log cocok dengan app.log dan a/b/app.log, tetapi logs/*.log hanya cocok dengan logs/app.log, tidak dengan logs/2026/app.log.
• ? cocok dengan satu karakter kecuali /. file?.txt cocok dengan file1.txt, tetapi tidak dengan file10.txt.
• [a-z] cocok dengan satu karakter dalam rentang, sedangkan [!a-z] atau [^a-z] dengan satu karakter di luar rentang. *.py[cod] menangkap .pyc, .pyo, dan .pyd sekaligus. Kurung siku juga tidak cocok dengan /.
• Kelas karakter POSIX seperti [[:digit:]] juga bisa dipakai.

Dua bintang **

** hanya bermakna khusus ketika menempel pada garis miring.

Di posisi lain, misalnya ** pada foo** atau **bar, ia berperilaku seperti * biasa dan tidak melewati garis miring. docs/**/*.pdf cocok dengan docs/manual.pdf dan docs/a/b/manual.pdf, karena /**/ juga cocok dengan nol direktori.

Rangkuman dalam satu contoh kecil

# Hasil build (hanya direktori build di root)
/build/

# File log di kedalaman mana pun, kecuali log penting
*.log
!important.log

# Semua PDF di bawah docs
docs/**/*.pdf

# File yang namanya diawali #
\#scratch.md

Tabel ini bisa direproduksi persis dengan menempelkan aturan dan jalur ke tab Uji pola di generator.

Referensi

• Dokumentasi resmi gitignore (git-scm.com)
• GitHub Docs: Ignoring files
• Diperiksa per: 2026-09-23 (contoh diverifikasi dengan git 2.50.1)