Git Switch vs Checkout: Memahami Perbedaannya

Untuk waktu yang lama, git checkout menangani hampir semua hal terkait berpindah di dalam repositori, mengganti branch, memulihkan file, dan meninjau commit lama. Fleksibilitas itu menimbulkan ambiguitas. Sintaks yang sama bisa berarti hal berbeda tergantung konteks.

Salah ketik kecil bisa mengganti branch saat Anda bermaksud memulihkan file. Pemeriksaan riwayat cepat menggunakan git checkout <commit-hash> bisa membuat Anda berada pada keadaan HEAD terlepas (detached) tanpa disadari. Perintahnya memang berfungsi, tetapi membutuhkan kewaspadaan terus-menerus terhadap berbagai perilakunya.

Itulah sebabnya Git 2.23 memperkenalkan git switch, perintah yang lebih khusus untuk menangani operasi branch.

Dalam panduan ini, saya akan menunjukkan bagaimana git switch berbeda dari git checkout. Kita juga akan membahas di mana masing-masing perintah cocok dalam alur kerja modern dan melihat cakupannya.

Jika Git masih cukup baru bagi Anda, saya merekomendasikan mempelajari dasar-dasarnya dalam kursus Introduction to Git kami.

Apa Itu Git Switch?

git switch adalah perintah khusus yang diperkenalkan di Git 2.23 untuk mengelola navigasi dan pembuatan branch. Perintah ini membuat perpindahan antar branch menjadi lebih rapi, aman, dan minim kesalahan.

Sebelum diperkenalkan, para pengembang menggunakan git checkout untuk mengganti branch. Masalahnya, git checkout menangani banyak tugas yang tidak terkait:

• Berpindah branch
• Memulihkan file
• Meninjau commit

Hal ini membuat perintahnya terlalu banyak fungsi dan lebih mudah disalahgunakan.

Git mengatasinya dengan memisahkan tanggung jawab. git switch kini menangani perpindahan dan pembuatan branch, sementara git restore menangani pemulihan file. Pemisahan ini mengurangi ambiguitas dan menurunkan risiko perubahan file yang tidak disengaja.

Dalam praktiknya, git switch branch-name memindahkan penunjuk HEAD Anda saat ini ke nama branch yang ditentukan. Anda juga dapat menggunakan git switch -c new-branch untuk membuat dan langsung berpindah ke branch baru.

Mekanisme Inti Git Switch vs Checkout

Sekarang setelah Anda memahami mengapa git switch diperkenalkan, mari kita lihat bagaimana perbedaannya dari git checkout pada tingkat internal.

Manajemen branch yang dibuat khusus

Sebelum Git 2.23, git checkout menangani navigasi branch dan pemulihan file sekaligus. Desain itu berfungsi, tetapi mencampur dua konsep yang secara fundamental berbeda. Ia memindahkan HEAD, memulihkan file, dan checkout commit. Bergantung pada bagaimana Anda menggunakannya, ia memanipulasi penunjuk HEAD, index, dan working tree.

git switch berfokus secara eksklusif pada memindahkan penunjuk HEAD antar branch. Saat Anda menjalankan git switch branch-name, Git memperbarui HEAD untuk menunjuk ke branch tersebut dan menyesuaikan direktori kerja agar sesuai. Jadi perintah ini ada khusus untuk navigasi dan pembuatan branch. Dengan git switch dan git restore, tanggung jawabnya terbagi jelas:

• git switch memindahkan HEAD antar branch.

• git restore memodifikasi file di working tree atau index.

Misalnya, memulihkan file sebelumnya membutuhkan: git checkout HEAD -- file.txt. Kini, pendekatan yang direkomendasikan adalah: git restore file.txt.

Di sini, Anda memulihkan file, bukan menavigasi branch. Dalam skrip dan dokumentasi tim, pembedaan ini meningkatkan keterbacaan dan mengurangi kesalahan.

Evolusi perintah Git

Git 2.23 memisahkan tanggung jawab dengan memperkenalkan git switch untuk operasi branch dan git restore untuk pemulihan file.

Sebelum rilis itu, git checkout berfungsi sebagai alat serbaguna. Ia bisa mengganti branch, memulihkan file, atau berpindah ke commit sewenang-wenang. Namun, ini menimbulkan kebingungan, terutama bagi pengguna baru. Karena itu, dengan memecah perintahnya, Git mengurangi ambiguitas dan membuat alur kerja umum lebih jelas.

Perilaku detached HEAD

Dalam Git, HEAD biasanya menunjuk ke sebuah branch. Branch itu, pada gilirannya, menunjuk ke commit terbaru. Saat Anda membuat commit baru, Git memajukan branch tersebut. Ini adalah alur kerja standar.

Detached HEAD terjadi ketika HEAD menunjuk langsung ke sebuah commit alih-alih branch. Dalam keadaan itu, Anda tidak lagi berada pada sebuah branch. Jika Anda membuat commit baru, Git akan membuatnya, tetapi tidak ada nama branch yang mereferensikannya. Kecuali Anda secara eksplisit membuat branch, commit-commit itu tetap tidak direferensikan dan bisa sulit ditemukan nanti.

Saat Anda menjalankan git checkout <commit-hash>, Git secara otomatis masuk ke mode detached HEAD. Git berpindah ke commit tersebut dan melepaskan HEAD tanpa membutuhkan konfirmasi tambahan. Perilaku ini valid, tetapi mudah membuat Anda otomatis masuk ke mode detached.

Di sisi lain, git switch memerlukan penyebutan eksplisit. Untuk melepaskan HEAD, Anda harus menggunakan git switch --detach <commit-hash>. Tanpa flag --detach, git switch hanya beroperasi pada branch. Desain ini mengurangi keadaan detached yang tidak disengaja dan membuat alur kerja branch lebih aman serta lebih dapat diprediksi.

Perbedaan Fungsional Utama Git Switch vs Checkout

Setelah kita membahas perbedaan tingkat tinggi antara kedua perintah tersebut, mari lihat sintaks, cakupan, dan pertimbangan keamanannya.

Sintaks perintah dan pembuatan

Untuk membuat dan berpindah ke branch baru dengan git switch, jalankan git switch -c <branch-name>. Dengan git checkout, perintah setara adalah git checkout -b <branch-name>.

Kedua perintah membuat branch baru dan berpindah ke sana, tetapi perbedaannya terletak pada seberapa jelas perintah menyatakan tujuannya. Di git switch, flag -c secara langsung menandakan bahwa Anda membuat branch, sementara di git checkout, -b secara historis berarti “branch,” namun kurang eksplisit dalam maksudnya.

git switch juga memperkenalkan flag -C: git switch -C <branch-name>. Efeknya lebih kuat daripada flag -c: Ia secara paksa membuat branch, atau meresetnya jika sudah ada. Perilaku ini eksplisit dan berfokus pada branch. Di git checkout, perilaku paksa serupa ada, tetapi semantiknya kurang terpisah dengan jelas karena perintahnya melayani banyak tujuan.

Cakupan operasi

git switch hanya berfungsi dengan branch. Ia tidak dapat memulihkan file, menghapus staging perubahan, atau checkout path tertentu dari commit sebelumnya. Intinya, ia tidak mendukung operasi pada level file.

Sebaliknya, git checkout bisa beroperasi pada level file. Misalnya, git checkout <commit> -- <file> memulihkan file tertentu dari commit lampau.

Namun, dokumentasi Git modern menyarankan menggunakan git restore untuk tujuan ini. Poin utamanya adalah git switch sengaja mengecualikan manipulasi file untuk menjaga cakupannya sempit dan dapat diprediksi.

Keamanan dan disambiguasi

Salah satu masalah umum dengan git checkout adalah ambiguitas. Jika nama branch dan nama file identik, bergantung konteks, ia bisa mengganti branch atau memulihkan file. git switch sepenuhnya menghindari ambiguitas ini. Ia hanya beroperasi pada branch. Jika Anda tidak memberikan nama branch yang valid, Git akan jelas gagal alih-alih menebak.

git switch juga memberikan penanganan error yang lebih jelas saat perubahan lokal berbenturan dengan branch target. Jika perpindahan branch akan menimpa pekerjaan yang belum di-commit, Git menghentikan operasi dan menampilkan pesan error langsung, seperti berikut:

• Jika branch tidak ada: fatal: invalid reference: feature/login

• Jika perubahan lokal akan tertimpa: error: Your local changes to the following files would be overwritten by checkout

• Jika branch sudah ada saat menggunakan -c: fatal: a branch named 'feature/login' already exists

Pesan error yang jelas seperti ini mengurangi perubahan status yang tidak disengaja.

Contoh Praktis Git Switch

Memahami git switch menjadi jauh lebih mudah setelah Anda melihatnya dalam alur kerja nyata. Contoh-contoh ini menunjukkan bagaimana perilakunya dalam manajemen branch sehari-hari dan mengapa terasa lebih aman serta lebih dapat diprediksi dibanding git checkout.

Operasi branch standar

Dalam pengembangan harian, Anda terutama berpindah antar branch atau membuat yang baru.

• Untuk berpindah ke branch lokal yang sudah ada, gunakan: git switch <branch_name>. Di sini, git memindahkan HEAD ke nama branch yang disebutkan dan memperbarui direktori kerja Anda agar sesuai dengan branch tersebut.

• Untuk membuat branch baru untuk fitur baru bernama “new_ui” dan langsung berpindah ke sana dalam satu langkah, gunakan git switch -c feature/new-ui. Ini membuat branch dari commit Anda saat ini dan segera memindahkan HEAD ke sana.

• Jika Anda perlu mereset atau menimpa branch yang sudah ada, gunakan: git switch -C feature/new-ui. Huruf kapital -C memaksa pembuatan atau mereset penunjuk branch. Ini membuat niat destruktif menjadi eksplisit.

• Anda juga dapat dengan cepat beralih antara dua branch terakhir menggunakan git switch -. Ini sangat berguna saat meninjau kode di satu branch dan berulang kali kembali ke branch fitur Anda.

Menangani branch remote

Sering kali, sebuah branch ada di remote tetapi belum ada secara lokal. Misalnya, seseorang mendorong origin/bugfix, tetapi Anda belum membuatnya.

• Jika Anda menjalankan: git switch bugfix, Git akan membuat branch bugfix lokal dan menyetelnya untuk melacak branch remote origin/bugfix, dengan asumsi ada kecocokan yang jelas di origin. Ini menyederhanakan kolaborasi karena Anda tidak perlu secara manual menyetel pelacakan upstream.

• Jika Anda ingin mencegah Git menebak, gunakan: git switch --no-guess bugfix. Kini Git akan gagal jika branch tidak ada secara lokal. Ini berguna dalam alur kerja yang lebih ketat di mana pelacakan otomatis bisa menimbulkan kebingungan.

• Jika Anda lebih suka eksplisit saat membuat branch pelacak, gunakan git switch -c bugfix --track origin/bugfix. Ini membuat hubungan pelacakan jelas dalam perintah itu sendiri.

Peninjauan commit eksperimental

Terkadang Anda hanya ingin melihat commit lama. Mungkin Anda ingin menguji versi sebelumnya atau memverifikasi kapan sebuah bug diperkenalkan. Dalam kasus itu, Anda ingin berpindah sementara ke titik tersebut dalam riwayat.

Dengan git switch, Anda harus menyatakannya secara eksplisit: git switch --detach <commit-hash>.

Flag --detach memberi tahu Git: pindahkan HEAD langsung ke commit ini, bukan ke sebuah branch. Anda kini dapat menelusuri kode, menjalankan pengujian, atau membangun proyek. Jika Anda membuat commit baru dalam keadaan ini, commit tersebut tidak terlampir pada branch mana pun kecuali Anda membuatnya.

Dengan git checkout <commit-hash>, tindakan yang sama terjadi secara otomatis tanpa flag tambahan. Ini membuat Anda mudah masuk ke mode detached tanpa disengaja, sedangkan kewajiban menggunakan flag --detach di git switch mencegah keadaan detached HEAD yang tidak diinginkan.

Integrasi Alur Kerja Git Switch

Selanjutnya, mari lihat bagaimana Anda dapat mengintegrasikan git switch ke dalam alur kerja Git yang umum.

Pemilihan berbasis skenario

Dalam alur kerja pengembangan modern, git switch seharusnya menangani semua pekerjaan terkait branch. Itu mencakup

• Pengembangan fitur rutin
• Meninjau pull request
• Rebase secara lokal
• Skrip CI/CD yang melakukan checkout branch selama build

Karena git switch hanya berfokus pada manajemen branch, perintah ini menyampaikan maksud dengan jelas.

git checkout masih memiliki peran, tetapi kini lebih sempit. Otomasi lama yang ditulis sebelum Git 2.23 sering mengandalkannya. Tugas pengembalian file tertentu mungkin juga masih menggunakannya, meskipun ke depan git restore adalah pengganti yang disukai.

Pemecahan masalah error umum

Ada dua skenario berbeda yang dapat menyebabkan masalah saat menggunakan git switch.

“Your local changes would be overwritten”

Salah satu masalah umum yang muncul saat Anda mencoba mengganti branch dengan adanya perubahan lokal adalah “error: Your local changes would be overwritten”. Di sini, Git memblokir operasi karena perpindahan akan menimpa pekerjaan yang belum di-commit. Anda memiliki dua opsi aman untuk mengatasinya:

1. Jika Anda ingin menyimpan perubahan untuk nanti, jalankan git stash sebelum Anda berpindah ke branch target. Setelah berpindah, Anda dapat memulihkannya menggunakan git stash pop.

2. Jika Anda memang ingin membuang perubahan lokal, gunakan: git switch --discard-changes target-branch. Opsi ini memberi tahu Git untuk membuang perubahan lokal dan mereset index serta working tree agar sesuai dengan branch target (tidak menghapus file yang tidak dilacak).

Tanpa sengaja masuk keadaan detached HEAD

Skenario lain adalah tanpa sengaja masuk ke keadaan HEAD terlepas. Jika Anda menyadari bahwa Anda tidak berada pada sebuah branch tetapi memiliki pekerjaan yang ingin disimpan, segera buat branch baru: git switch -c recovery-branch. Ini melampirkan riwayat commit Anda saat ini ke branch bernama dan mempertahankan perubahan Anda.

Praktik Terbaik dalam Mengadopsi Git Switch

Mengadopsi git switch bukan sekadar preferensi perintah. Ini adalah peningkatan struktural kecil tentang bagaimana tim memikirkan alur kerja Git. Manfaatnya meningkat ketika adopsi konsisten di seluruh dokumentasi, onboarding, dan otomasi.

Strategi migrasi tim

Mulailah dengan dokumentasi internal Anda. Jika panduan “Getting Started” Anda masih mengajarkan git checkout untuk perpindahan branch, perbarui menjadi git switch. Pertahankan checkout hanya di tempat yang benar-benar diperlukan.

Pelatihan juga berperan. Perintah Git modern menyediakan pesan error yang lebih jelas, terutama ketika perubahan lokal berbenturan dengan perpindahan branch. Dorong pengembang untuk membaca dan memahami pesan-pesan ini alih-alih menganggapnya sebagai kegagalan umum. Kumpulan perintah yang lebih baru lebih eksplisit, dan menyadari hal itu meningkatkan kepercayaan diri serta mengurangi kesalahan.

Konsistensi dalam otomasi

Dalam skrip shell, pipeline CI, dan alias Git, utamakan git switch untuk navigasi branch karena langsung menyampaikan maksud. Skrip yang menggunakan git switch main lebih mudah ditafsirkan daripada yang mengandalkan git checkout, yang bisa memiliki banyak makna.

Jika Anda mendefinisikan alias Git, perbarui agar mencerminkan penggunaan modern. Misalnya, alias untuk membuat branch fitur sebaiknya membungkus git switch -c, bukan git checkout -b.

Terakhir, verifikasi versi Git di seluruh lingkungan. git switch memerlukan Git 2.23 atau lebih baru. Pastikan mesin pengembang lokal, runner CI, dan server build memenuhi persyaratan ini sebelum standarisasi pada perintah baru. Pemeriksaan versi sederhana mencegah masalah kompatibilitas yang halus.

Kesimpulan

Jika Anda mundur sejenak dan melihat gambaran besarnya, keunggulan nyata dari git switch itu sederhana. Ia membuat manajemen branch lebih jelas, lebih aman, dan lebih disengaja. Saat Anda menjalankan perintahnya, tidak ada ambiguitas tentang apa yang dilakukannya. Anda sedang mengganti branch. Itu saja. Dan tingkat kejelasan kecil itu menghilangkan cukup banyak friksi dari pengembangan sehari-hari.

Namun, git checkout tidak dihentikan; Anda tetap dapat menggunakannya untuk memulihkan file, berpindah antar branch, atau menangani skenario yang lebih kompleks. Tetapi untuk navigasi branch harian, Git menganjurkan Anda menggunakan git switch.

Langkah berikutnya, saya merekomendasikan untuk mengikuti kours Intermediate Git, yang berfokus pada kolaborasi menggunakan Git.