Tutorial Git Commit: Cara Melacak dan Mendokumentasikan Perubahan Kode

Git telah menjadi sistem andalan untuk mengelola perubahan pada basis kode. Salah satu perintah paling krusial di Git adalah git commit, yang menangkap cuplikan riwayat proyek Anda pada titik waktu tertentu.

Memahami cara menggunakan git commit secara efisien sangat penting untuk menjaga riwayat proyek tetap bersih dan terorganisasi. Menulis pesan commit yang bermakna dan mengikuti praktik terbaik memastikan repositori Anda tetap mudah dikelola, baik saat Anda bekerja sendiri maupun sebagai bagian dari tim yang lebih besar. 

Tutorial ini bertujuan mengajarkan cara menggunakan perintah git commit, menulis pesan commit yang jelas dan informatif, serta menerapkan praktik terbaik untuk kontrol versi yang sukses.

Mari kita mulai!

Apa itu Git Commit?

Salah satu blok bangunan paling mendasar dari kontrol versi di Git adalah perintah git commit. Sebuah git commit menangkap cuplikan keadaan saat ini dari file-file yang sudah di-stage dan menyimpannya ke riwayat repositori. Ini membuat pengenal unik untuk perubahan tersebut dan mencatat metadata penting, seperti penulis, stempel waktu, dan pesan commit deskriptif—ini memastikan modifikasi dapat dilacak, dipahami, dan dibatalkan jika diperlukan. 

Pengembang juga dapat menambahkan pesan commit, yang secara singkat menjelaskan perubahan yang dilakukan serta memberikan konteks dan alasan di balik pembaruan.

Pada intinya, commit penting karena memungkinkan pengembang untuk:

• Melacak perubahan: Commit memberikan catatan jelas atas modifikasi yang dilakukan pada basis kode dari waktu ke waktu.
• Berkolaborasi: Dalam pengaturan tim, commit membantu pengembang memahami perubahan apa yang dilakukan, oleh siapa, dan mengapa.
• Kembali ke keadaan sebelumnya: Jika muncul bug atau masalah, commit memungkinkan pengembang untuk menggulirkan proyek ke titik stabil sebelum perubahan bermasalah tersebut diperkenalkan.
• Menjaga riwayat tetap rapi: Commit yang terstruktur dan sering dengan pesan yang bermakna memudahkan pengelolaan proyek besar dan diagnosis masalah.

> Jika Anda baru memulai dengan Git dan GitHub, jalur GitHub Foundations menawarkan jalur kurasi untuk membantu Anda menguasai dasar-dasar kontrol versi dan alur kerja kolaborasi.

Sintaks Dasar Git Commit

Untuk menggunakan Git secara efektif, Anda harus memahami sintaks dan struktur dasar commit. Bagian ini mengulas komponen inti dari proses commit agar perubahan tercatat dan didokumentasikan dengan benar.

Perintah dasar

Cara paling sederhana untuk membuat commit adalah dengan menggunakan perintah berikut: 

git commit -m “Your commit message” Didukung oleh

Di sini, flag -m memungkinkan Anda menyertakan pesan commit singkat yang mendeskripsikan perubahan. Di sinilah Anda memberikan konteks untuk referensi di masa mendatang dan kolaborasi, contohnya: 

git commit -m “Fix bug in user authentication” Didukung oleh

Perintah ini membuat commit dan mengaitkannya dengan pesan yang disediakan. 

Apa yang terjadi selama commit

Berikut yang terjadi di balik layar saat Anda melakukan commit: 

1. Staging perubahan: Sebelum melakukan commit, Anda harus melakukan staging perubahan menggunakan perintah git add. Ini menyiapkan file yang dimodifikasi untuk disertakan dalam commit berikutnya. Anda dapat melakukan staging per file atau semua file yang dimodifikasi. 

git add file.txt  #Stages one file
git add .  #Stages all files in the current directoryDidukung oleh

2. Membuat commit: Setelah perubahan Anda di-stage, perintah git commit mengambil cuplikan file yang di-stage dan menyimpannya di repositori. Perlu dicatat bahwa cuplikan tersebut adalah keadaan terkini file pada saat itu.
3. Memperbarui repositori: Setelah commit, Git memperbarui riwayat proyek untuk menyimpan commit berdampingan dengan semua commit sebelumnya. Setiap commit bertindak sebagai titik pemeriksaan yang dapat digulirkan kembali jika diperlukan.

Menulis Pesan Git Commit yang Efektif

Menulis pesan commit yang jelas dan bermakna sangat penting untuk menjaga riwayat proyek yang bersih dan mudah dipahami. Pesan commit yang ditulis dengan baik juga berfungsi sebagai alat komunikasi, membantu pengembang dan kolaborator dengan cepat memahami tujuan dan konteks setiap perubahan.

Pentingnya pesan commit yang baik

Pesan commit yang baik bertindak sebagai peta. Pesan tersebut memberikan wawasan tentang alasan di balik setiap perubahan, yang menjadi sangat berharga saat meninjau kode di kemudian hari atau menelusuri masalah. Pesan commit yang ditulis dengan baik juga memudahkan penelusuran bug, memahami evolusi fitur, dan menavigasi riwayat repositori. 

Praktik terbaik untuk pesan commit

Agar pesan commit Anda berfungsi sebagaimana mestinya, ikuti praktik terbaik berikut:

1. Bersifat deskriptif: Pesan commit harus menjelaskan apa yang diubah dan, bila relevan, mengapa perubahan dilakukan. Hindari pesan yang samar atau generik seperti "fix" atau "update." Alih-alih, utamakan spesifik. Misalnya, “Fix login form validation error” jauh lebih membantu daripada sekadar “Bug fix.”
2. Gunakan kala kini: Pesan commit sebaiknya ditulis dalam kala kini. Ini memberi kesan bahwa Anda sedang menggambarkan apa yang dilakukan commit pada saat itu. Misalnya, gunakan "Add login validation" alih-alih "Added login validation."
3. Singkat dan sederhana: Pesan yang ringkas lebih mudah dibaca. Ringkasan (baris pertama pesan commit) idealnya 50–72 karakter, dan jika butuh penjelasan lebih, Anda dapat menyertakan deskripsi lebih panjang di baris berikutnya. Pendekatan ini memastikan pesan mudah dilihat menggunakan berbagai alat dan antarmuka Git.
4. Gunakan poin-poin untuk perubahan terperinci: Jika commit Anda mencakup beberapa perubahan terkait, gunakan poin-poin dalam deskripsi lanjutan untuk merinci apa yang dilakukan. Ini membantu membuat struktur yang jelas, sehingga lebih mudah diikuti.

> Jika Anda ingin melampaui dasar-dasar commit, kursus Intermediate Git mengulas konsep yang lebih lanjut seperti amend, rebase, dan pengelolaan riwayat commit dalam tim.

Opsi Lanjutan Git Commit

Flag -m adalah opsi umum yang digunakan dalam perintah git commit, dan sudah cukup untuk penggunaan harian. Namun, beberapa opsi lanjutan lain menyediakan fleksibilitas dan efisiensi lebih saat mengelola perubahan. Di bagian ini, kita akan melihat opsi-opsi tersebut. 

Commit tanpa staging

Dalam banyak kasus, melakukan staging file secara manual dengan git add sebelum commit mungkin terasa tidak perlu, terutama ketika semua file yang dimodifikasi harus di-commit. Untuk mempercepat proses ini, Git menyediakan flag -a, yang melakukan staging semua file yang dilacak dan langsung melakukan commit dalam satu langkah. Ini berarti perubahan apa pun pada file yang sebelumnya sudah dilacak akan disertakan dalam commit tanpa harus menjalankan git add secara eksplisit.

Berikut cara kerjanya:

git commit -a -m “Your commit message” Didukung oleh

Mengubah commit (amend)

Kesalahan bisa terjadi. Terkadang, Anda perlu mengubah commit yang baru saja dibuat. Opsi --amend memungkinkan Anda memodifikasi commit terbaru alih-alih membuat yang baru. Ini memungkinkan Anda memperbarui pesan commit atau menambahkan file tambahan ke commit yang sama.

Misalnya, untuk memperbaiki pesan commit terakhir: 

git commit --amend -m "Update commit message"Didukung oleh

Atau, jika Anda lupa melakukan staging sebuah file, tambahkan dulu filenya, lalu amend commit tersebut:

git add missed-file.txt
git commit --amendDidukung oleh

Ini secara efektif menggantikan commit sebelumnya dengan yang telah diperbarui. 

Perhatikan bahwa amend sebaiknya hanya dilakukan pada commit yang belum dibagikan kepada orang lain (misalnya, belum di-push ke repositori bersama) untuk menghindari penulisan ulang riwayat yang mungkin diandalkan orang lain!

Commit dengan perubahan dan file dari commit tertentu

Terkadang, Anda perlu memperbaiki masalah pada commit sebelumnya tanpa membuat perubahan yang tidak terkait. Git menawarkan opsi --fixup, yang membantu membuat commit susulan yang secara khusus ditautkan ke commit sebelumnya. Ini sangat berguna saat Anda perlu merapikan riwayat commit sebelum menggabungkan perubahan Anda.

Misalnya, untuk membuat fixup untuk commit tertentu:

git commit --fixup <commit-hash>Didukung oleh

Perintah ini akan membuat commit baru yang dimaksudkan untuk menangani masalah pada commit yang ditentukan. 

Nantinya, saat Anda melakukan rebase interaktif, Git dapat otomatis menyatukan (squash) commit fixup ini dengan commit asli yang dirujuknya.

> Untuk alur kerja lanjutan seperti squash commit, Anda dapat mengikuti panduan terperinci kami di tutorial Git Squash Commits.

Mengelola Commit dengan Git

Seiring proyek berkembang dan riwayat commit bertambah, mengelola commit menjadi aspek krusial untuk menjaga repositori tetap terorganisasi dan mudah dinavigasi. Manajemen commit yang efektif membantu proses debugging, kolaborasi, dan menjaga riwayat yang bersih serta mudah dipahami. 

Git menyediakan alat yang kuat yang memungkinkan Anda melihat riwayat commit serta merevisi atau bahkan membatalkan perubahan bila diperlukan. Mengetahui cara mengelola commit ini dapat menghemat banyak waktu saat menyelesaikan masalah atau merapikan riwayat proyek Anda.

Melihat riwayat commit

Aspek penting dari manajemen commit adalah memahami riwayat proyek. Perintah git log memungkinkan Anda melihat riwayat commit secara terperinci. Untuk konteks, perintah ini memberikan wawasan tentang kapan perubahan dilakukan, siapa yang melakukannya, dan pesan apa yang dilampirkan.

Sebagai contoh, berikut perintah dasar git log:

git logDidukung oleh

Ini menampilkan hash commit, nama penulis, tanggal, dan pesan commit. 

Namun Git juga memungkinkan Anda menyesuaikan keluaran log sesuai kebutuhan. Misalnya, Anda dapat membatasi jumlah commit yang ditampilkan seperti berikut: 

git log -n 5 # shows the last 5 commitsDidukung oleh

Untuk menelusuri perubahan yang dibuat di setiap commit, gunakan flag -p, yang menampilkan diff untuk setiap commit. 

Seperti ini contohnya:

git log -pDidukung oleh

Membatalkan atau mengurungkan commit

Terkadang, Anda perlu mundur atau membatalkan perubahan. Salah satu cara aman untuk mengurungkan commit adalah dengan menggunakan git revert perintah. Ini membuat commit baru yang membatalkan perubahan yang diperkenalkan oleh commit sebelumnya tanpa mengubah riwayat commit.

Ini sangat berguna ketika Anda sudah membagikan commit dengan orang lain dan ingin menjaga riwayat tetap utuh.

Untuk membatalkan sebuah commit, gunakan perintah berikut:

git revert <commit-hash>Didukung oleh

Perintah ini menerapkan kebalikan dari perubahan commit yang ditentukan, secara efektif mengurungkannya sekaligus mempertahankan riwayat yang transparan.

Mereset commit

Dalam beberapa kasus, Anda mungkin ingin sepenuhnya mereset repositori ke keadaan sebelumnya, menghapus satu atau lebih commit. Perintah git reset memungkinkan Anda melakukan hal tersebut. Namun, mereset commit memodifikasi riwayat commit, sehingga harus digunakan dengan hati-hati, terutama jika perubahan sudah di-push ke repositori bersama.

Git reset menawarkan tiga mode:

1. Soft reset: Memindahkan penunjuk commit kembali ke commit tertentu tetapi mempertahankan perubahan di working directory dan staging area. Ini berguna ketika Anda ingin mengulang commit namun tetap mempertahankan perubahan Anda. 

git reset --soft <commit-hash>Didukung oleh

2. Mixed reset: Memindahkan penunjuk commit kembali ke commit tertentu dan mempertahankan perubahan di working directory, tetapi mengosongkan staging area. Ini adalah mode reset default Git.

git reset --mixed <commit-hash>Didukung oleh

3. Hard reset: Memindahkan penunjuk commit kembali ke commit tertentu dan menghapus semua perubahan di working directory maupun staging area. Ini pada dasarnya mengembalikan repositori Anda ke keadaan commit yang dipilih dan menghapus perubahan apa pun yang dibuat setelah commit tersebut. 

git reset --hard <commit-hash>Didukung oleh

Perintah git reset adalah alat yang kuat, namun penting untuk memahami implikasinya (terutama saat bekerja di lingkungan kolaboratif).  

Praktik Terbaik untuk Melakukan Commit di Git

Kontrol versi yang efektif bukan hanya soal mengetahui perintah Git—tetapi juga mengikuti praktik terbaik tertentu untuk menjaga riwayat proyek yang bersih, mudah dipahami, dan efisien. Praktik ini tidak hanya membantu Anda mengelola pekerjaan sendiri, tetapi juga memudahkan kolaborator untuk berkontribusi dan meninjau perubahan.

Sering melakukan commit, namun tetap kecil

Aturan praktis yang baik adalah melakukan commit lebih awal dan sering, tetapi menjaga setiap commit tetap kecil dan fokus. Pendekatan ini memastikan setiap commit mewakili unit kerja yang berbeda dan logis. 

Melakukan commit secara sering dapat membantu memecah perubahan besar menjadi bagian yang lebih mudah dikelola, sehingga lebih mudah ditinjau, diuji, dan ditelusuri evolusi proyek Anda. Dengan melakukan commit yang lebih kecil dan terisolasi, Anda juga mengurangi risiko menimbulkan kesalahan yang kompleks. Jika terjadi masalah, lebih mudah mengisolasi dan memperbaikinya ketika commit bersifat granular.

Hanya commit perubahan yang terkait

Setiap commit harus berfokus pada satu tugas atau isu. Mencampur perubahan yang tidak terkait dalam satu commit membuatnya lebih sulit ditinjau dan dipahami maksud di balik modifikasi tersebut. Ini juga mempersulit proses membatalkan atau memilih (cherry-pick) perubahan tertentu jika diperlukan.

Sebagai contoh, jika Anda sedang mengerjakan sebuah fitur namun menemukan bug kecil di bagian lain kode, lebih baik menanganinya sebagai dua commit terpisah. Ini memungkinkan pemahaman yang jelas tentang apa yang dilakukan dan mengapa—juga memastikan setiap commit bermakna dan terisolasi.

Berkolaborasi dengan orang lain pada riwayat commit

Saat bekerja dalam tim, menyelaraskan dengan kolaborator tentang bagaimana commit ditangani dan disajikan adalah hal yang penting. Ini mencakup kesepakatan format pesan commit yang konsisten dan memastikan semua orang mengikuti praktik terbaik. Git hooks, seperti pre-commit hook, dapat membantu menegakkan aturan seperti format pesan commit atau menjalankan pengujian sebelum commit diizinkan.

Kolaborasi juga ditingkatkan oleh alat yang membantu mengelola dan meninjau commit, seperti platform ulasan kode seperti GitHub atau GitLab. Riwayat commit yang jelas dan terdokumentasi dengan baik memudahkan anggota tim untuk memahami perubahan, mendiskusikan perbaikan, dan menjaga proyek tetap maju secara efisien.

> Ingin merapikan file sisa sebelum commit? Pelajari cara menggunakan git clean dalam tutorial menghapus file yang tidak terlacak ini.

Pemecahan Masalah Umum pada Git Commit

Git commit terkadang menimbulkan error atau tantangan yang dapat memperlambat alur kerja Anda. Memahami cara mengatasi masalah umum ini sangat penting untuk menjaga kontrol versi yang lancar dan menghindari masalah yang lebih besar di kemudian hari.

Kesalahan pesan commit

Kesalahan umum saat melakukan commit adalah lupa menambahkan pesan commit atau tanpa sengaja menggunakan pesan yang samar atau kosong. Pesan commit yang jelas dan informatif sangat penting untuk melacak perubahan dan memungkinkan kolaborator memahami riwayat sebuah proyek. Git biasanya mencegah Anda melakukan commit tanpa pesan, tetapi kualitas pesan itu sendiri tetap bisa terlewat.

Solusi: Selalu periksa ulang pesan commit sebelum menekan enter. Jika Anda tidak sengaja mengirim commit dengan pesan kosong atau tidak jelas, Anda dapat memperbaikinya menggunakan perintah git commit --amend untuk memodifikasi pesan commit terbaru. 

Konflik setelah commit

Konflik tidak terhindarkan saat banyak orang bekerja pada proyek yang sama. Konflik sering muncul setelah commit ketika Anda melakukan merge cabang atau rebase. Konflik terjadi ketika Git tidak dapat secara otomatis menyelesaikan perbedaan antara dua commit, sehingga Anda harus memilih secara manual perubahan mana yang dipertahankan.

Konflik paling mungkin terjadi ketika dua atau lebih kontributor memodifikasi bagian kode yang sama atau ketika dilakukan refactor besar pada proyek. Meskipun bisa terasa menakutkan, Git menyediakan alat untuk menyelesaikan konflik ini tanpa kehilangan data.

Solusi: Saat terjadi konflik, Git akan menandai bagian yang bertentangan di file, dan Anda perlu menyelesaikannya secara manual dengan mengedit file agar mencerminkan perubahan yang diinginkan. Setelah melakukan perubahan yang diperlukan, lakukan staging file dengan git add, lalu selesaikan merge atau rebase dengan melakukan commit atas perubahan yang telah diselesaikan. Alat seperti editor konflik merge Git atau alat merge eksternal juga dapat membantu Anda menyelesaikan konflik dengan lebih efisien.

Kesimpulan

Perintah git commit adalah aspek mendasar dari kontrol versi di Git yang memungkinkan pengembang membuat cuplikan pekerjaan mereka yang dapat dilacak, ditinjau, dan dikunjungi kembali dari waktu ke waktu. Commit berfungsi sebagai tonggak dalam riwayat proyek, memperjelas perubahan apa yang dilakukan, mengapa diperlukan, dan kapan diimplementasikan.

Dalam tutorial ini, kita membahas sintaks dasar dan proses membuat commit, mulai dari melakukan staging file dengan git add hingga menyelesaikan commit dengan git commit. Kita membahas pentingnya menulis pesan commit yang jelas dan ringkas, mengikuti praktik terbaik seperti menjaga pesan tetap deskriptif, menggunakan kala kini, dan tetap singkat. 

Selain itu, kita menjelajahi opsi lanjutan, seperti melakukan commit tanpa staging dan mengubah commit (amend), yang menawarkan fleksibilitas saat mengelola perubahan Anda. Kita juga melihat cara mengelola commit melalui perintah seperti git log, revert, dan reset.

Siap mengeksplorasi GitHub lebih dalam? Kursus GitHub Concepts kami membahas fork, branch, issue, dan praktik terbaik kolaborasi. Jika Anda bersiap untuk alur kerja dunia nyata atau wawancara, Complete Git Cheat Sheet adalah referensi yang bagus untuk selalu siap sedia!