Standar Penamaan File: snake_case, kebab-case, camelCase, dan Aturannya

Penamaan file terlihat sepele sampai suatu hari Anda membuka folder berisi Final.docx, Final_fix.docx, Final_fix_REAL.docx, dan Final_fix_REAL_2.docx, lalu bingung sendiri mana yang benar. Buat developer, masalahnya lebih halus tapi lebih mahal: satu file dengan nama salah bisa membuat import patah, URL rusak, atau script otomasi berhenti. Kabar baiknya, ada standar yang sudah teruji puluhan tahun. Begitu tim Anda memakainya secara konsisten, banyak masalah kecil hilang dengan sendirinya.

Artikel ini membahas standar penamaan file dari dua sisi sekaligus: konvensi penulisan ala programmer (snake_case, kebab-case, camelCase, dan saudara-saudaranya) sekaligus aturan praktis yang berguna untuk siapa saja, termasuk yang tidak pernah menyentuh kode. Saya menuliskannya dari kebiasaan kerja sehari-hari mengelola sistem dan otomasi, di mana nama yang rapi adalah pembeda antara pekerjaan yang mengalir dan pekerjaan yang macet.

Kenapa penamaan file itu penting

Nama file bukan sekadar label. Ia menentukan apakah file bisa diurutkan, dicari, dibuka di perangkat lain, dipakai di tautan, dan diproses oleh mesin. Untuk tim non-teknis, penamaan yang baik berarti dokumen gampang ditemukan dan tidak ada drama soal versi. Untuk developer, penamaan yang konsisten berarti kode bisa diprediksi, otomasi berjalan mulus, dan tidak ada link yang patah saat pindah sistem operasi.

Intinya sama untuk keduanya: nama yang konsisten menghemat waktu, mengurangi kesalahan, dan membuat kerja sama tim jadi lebih ringan.

Keluarga "case": cara menyambung kata

Masalah pertama dalam penamaan adalah kita tidak boleh asal pakai spasi. Maka muncul berbagai gaya menyambung kata. Ini yang paling sering dipakai.

• snake_case menyambung kata dengan garis bawah dan huruf kecil, contoh laporan_penjualan_juni. Umum di Python, nama kolom database, dan file data.
• kebab-case menyambung kata dengan tanda hubung, contoh laporan-penjualan-juni. Ini standar untuk URL, file web, CSS, perintah terminal, dan nama package. Disebut juga dash-case atau spinal-case.
• camelCase menyatukan kata tanpa pemisah, huruf pertama kecil, kata berikutnya kapital, contoh laporanPenjualanJuni. Khas variabel di JavaScript dan Java.
• PascalCase mirip camelCase tapi huruf pertama juga kapital, contoh LaporanPenjualanJuni. Dipakai untuk nama class, komponen, dan tipe data.
• SCREAMING_SNAKE_CASE adalah snake_case huruf kapital semua, contoh MAX_RETRY atau API_KEY. Dipakai untuk konstanta dan environment variable.
• dot.case memakai titik sebagai pemisah, contoh app.config.json. Sering muncul di file konfigurasi dan penanda modul.
• Train-Case adalah kebab-case dengan tiap kata berkapital, contoh Content-Type. Khas header HTTP.
• flatcase menggabung semua tanpa pemisah dan huruf kecil, contoh mypackage. Dipakai di package Go dan sebagian import.

Untuk yang bukan developer, Anda tidak perlu menghafal semuanya. Cukup pegang dua: pakai kebab-case untuk apa pun yang akan jadi tautan atau file web, dan snake_case untuk file dokumen biasa. Keduanya aman dan mudah dibaca.

Kapan memakai yang mana

Aturan praktisnya, ikuti kebiasaan ekosistem tempat file itu hidup. URL dan file web pakai kebab-case karena ramah mesin pencari dan tidak sensitif huruf besar kecil. Variabel program ikut gaya bahasanya, misalnya camelCase di JavaScript dan snake_case di Python. Konstanta pakai SCREAMING_SNAKE_CASE supaya langsung kelihatan beda. Nama class dan komponen pakai PascalCase.

Yang penting bukan memilih yang paling keren, melainkan konsisten dalam satu konteks. Mencampur snake_case dan kebab-case di folder yang sama justru bikin pusing.

Aturan penamaan file yang berlaku untuk semua orang

Di luar soal case, ada aturan yang manfaatnya langsung terasa bahkan untuk Anda yang hanya berurusan dengan dokumen kantor.

Awali dengan tanggal format YYYY-MM-DD kalau urutan waktu penting, contoh 2026-06-29-laporan-rapat.md. Format ini membuat file otomatis terurut secara kronologis ketika diurutkan berdasarkan nama.

Gunakan penomoran dengan angka nol di depan untuk urutan, contoh 01-pendahuluan, 02-metode, sampai 10-penutup. Tanpa nol di depan, komputer akan menaruh 10 tepat setelah 1, bukan di akhir.

Tandai versi secara eksplisit dengan v2, v3, dan seterusnya, bukan dengan kata seperti fix atau final yang akhirnya beranak menjadi final_fix_beneran. Versi bernomor selalu lebih jujur.

Hindari spasi dan ganti dengan tanda hubung atau garis bawah, supaya nama aman dipakai di URL, terminal, dan script. Pakai huruf kecil semua agar konsisten lintas sistem operasi, karena Windows dan macOS tidak membedakan huruf besar kecil sementara Linux membedakannya. Batasi karakter hanya ke huruf, angka, tanda hubung, dan garis bawah, lalu hindari karakter khusus seperti garis miring, titik dua, tanda tanya, dan tanda bintang yang sebagian dilarang sistem. Tulis ekstensi dengan huruf kecil, jadi .jpg bukan .JPG.

Pola yang siap Anda pakai hari ini kira-kira begini: tanggal_proyek_deskripsi_versi.ekstensi, misalnya 2026-06-29_biver_proposal-kerjasama_v2.pdf. Rapi, mudah dicari, dan tidak akan menyusahkan siapa pun yang menerimanya.

Manfaat konkret yang akan Anda rasakan

Untuk developer, konsistensi penamaan berarti import tidak patah saat pindah dari macOS ke server Linux, rute URL menjadi rapi dan ramah SEO lewat kebab-case, otomasi dan script lebih mudah ditulis karena pola namanya dapat ditebak, dan riwayat perubahan di Git lebih bersih.

Untuk yang bukan developer, manfaatnya tidak kalah nyata. File terurut sendiri sehingga gampang dicari, tidak ada lagi kebingungan soal mana versi final, tautan yang dibagikan tidak rusak gara-gara ada spasi, dan seluruh tim memakai pola yang sama sehingga onboarding orang baru jauh lebih cepat.

Hubungannya dengan otomasi dan AI

Ada satu manfaat yang makin penting belakangan ini. Ketika pekerjaan mulai dibantu script otomasi atau alat berbasis AI, nama file yang rapi menjadi syarat diam-diam. Sistem otomatis bekerja paling baik ketika pola namanya konsisten dan dapat diprediksi. Nama yang berantakan memaksa Anda menulis pengecualian demi pengecualian, sementara nama yang rapi membuat alur kerja berjalan nyaris tanpa perawatan. Inilah salah satu kebiasaan dasar yang selalu saya tekankan ketika membantu tim merapikan cara kerja mereka, termasuk dalam program pelatihan AI untuk perusahaan, karena fondasi yang rapi membuat adopsi AI jauh lebih mulus.

Kesalahan umum yang sebaiknya dihindari

Beberapa kebiasaan kecil sering merusak sistem penamaan yang sudah rapi. Yang paling sering adalah memakai spasi dan karakter aneh seperti tanda kurung atau tanda seru, yang membuat file menyusahkan saat dibagikan atau diproses. Berikutnya adalah menandai versi dengan kata, bukan angka, sehingga final berkembang menjadi final-baru, lalu final-banget, dan akhirnya tidak ada yang tahu mana yang dipakai.

Kesalahan lain adalah mencampur gaya dalam satu folder, misalnya sebagian file pakai garis bawah dan sebagian pakai tanda hubung, sehingga pencarian jadi tidak konsisten. Ada juga kebiasaan menulis tanggal dengan format lokal seperti 29-06-2026, yang justru tidak terurut benar ketika diurutkan berdasarkan nama. Format 2026-06-29 jauh lebih aman. Terakhir, nama yang terlalu singkat seperti data1 atau terlalu panjang sampai satu kalimat sama-sama menyulitkan. Targetnya cukup: deskriptif, tetapi ringkas.

Pertanyaan yang sering diajukan

Apa bedanya snake_case dan kebab-case? Keduanya memakai huruf kecil, bedanya hanya pada pemisah. snake_case memakai garis bawah seperti nama_file, sedangkan kebab-case memakai tanda hubung seperti nama-file. Gunakan kebab-case untuk URL dan file web, dan snake_case untuk file data atau dokumen biasa.

Kalau bukan programmer, konvensi mana yang wajib saya pakai? Cukup dua kebiasaan: jangan pakai spasi dan gantilah dengan tanda hubung atau garis bawah, lalu awali nama dengan tanggal format tahun-bulan-tanggal bila urutan waktu penting. Dua kebiasaan ini saja sudah menyelesaikan sebagian besar masalah penamaan.

Kenapa tidak boleh ada spasi di nama file? Spasi menyulitkan banyak sistem. Di URL ia berubah menjadi kode aneh seperti persen dua puluh, di terminal ia memecah nama jadi beberapa bagian, dan di banyak script ia memicu error. Tanda hubung atau garis bawah jauh lebih aman.

Apakah huruf besar kecil berpengaruh? Bisa sangat berpengaruh. Linux membedakan File.txt dan file.txt sebagai dua berkas berbeda, sementara Windows dan macOS menganggapnya sama. Memakai huruf kecil semua menghindari kebingungan dan kesalahan saat file berpindah antar sistem.

---

Tentang Penulis

Rama Aditya adalah Founder Rama Digital, konsultan digital sekaligus praktisi AI yang membangun dan mengoperasikan sistem AI agent di lingkungan produksi. Ia menyelenggarakan pelatihan AI untuk perusahaan, dari program awareness dan produktivitas tim sampai workshop alur kerja berbasis agentic AI. Prinsip kerjanya: Smart Systems, Better Business.