Memverifikasi Instalasi

Pemasangan yang “sepertinya berhasil” belum tentu sehat: terminal yang belum dimuat ulang bisa saja masih tidak menemukan git, atau ada biner lama yang menang atas biner baru di PATH. Masalah semacam ini paling murah ditemukan sekarang, sebelum kita membangun konsep-konsep Git di atasnya. Chapter ini menjalankan tiga pemeriksaan berurutan — versi, lokasi biner, dan sistem bantuan — lalu membahas penyebab paling umum bila perintah Git tidak dikenali.

Memeriksa Versi Git #

Pemeriksaan pertama adalah perintah yang sudah kita pakai sepanjang section instalasi:

git --version

Output yang Dihasilkan:

git version 2.47.3

Teks keluaran terdiri dari dua bagian: frasa git version yang menandakan biner Git berhasil ditemukan dan dijalankan, lalu angka 2.47.3 — nomor rilis Git yang terpasang pada mesin uji Course ini. Angka pada komputer kita boleh berbeda, karena setiap platform menyediakan versi pada waktunya masing-masing. Selama baris git version <angka> muncul, pemeriksaan ini lolos.

Melacak Lokasi Biner Git #

Pemeriksaan kedua menjawab pertanyaan yang tidak terjawab oleh git --version: dari direktori mana shell menjalankan git:

which git

Output yang Dihasilkan:

/usr/bin/git

Shell mencari setiap perintah yang diketik ke daftar direktori bernama PATH, dari kiri ke kanan, lalu menjalankan kecocokan pertama yang ditemukan. Perintah which melaporkan kecocokan yang menang — pada mesin uji, /usr/bin/git. Informasi ini menjadi penting kelak: di macOS, /usr/bin/git menandakan Git dari Xcode Command Line Tools sedangkan /opt/homebrew/bin/git menandakan versi Homebrew; di Linux, /usr/bin/git adalah paket dari distro. Di Windows, padanannya adalah where git di Command Prompt atau Get-Command git di PowerShell.

Menguji Sistem Bantuan #

Pemeriksaan ketiga memastikan paket Git terpasang utuh — termasuk seluruh halaman bantuannya:

git help

Output yang Dihasilkan (dipotong):

usage: git [-v | --version] [-h | --help] [-C <path>] [-c <name>=<value>]
           [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
           [-p | --paginate | -P | --no-pager] [--no-replace-objects] [--no-lazy-fetch]
           [--no-optional-locks] [--no-advice] [--bare] [--git-dir=<path>]
           [--work-tree=<path>] [--namespace=<name>] [--config-env=<name>=<envvar>]
           <command> [<args>]

These are common Git commands used in various situations:

start a working area (see also: git help tutorial)
   clone     Clone a repository into a new directory
   init      Create an empty Git repository or reinitialize an existing one

work on the current change (see also: git help everyday)
   add       Add file contents to the index
   mv        Move or rename a file, a directory, or a symlink
   restore   Restore working tree files
   rm        Remove files from the working tree and from the index

(dipotong)

'git help -a' and 'git help -g' list available subcommands and some
concept guides. See 'git help <command>' or 'git help <concept>'
to read about a specific subcommand or concept.
See 'git help git' for an overview of the system.

Bagian paling berguna dari keluaran tersebut adalah daftar perintah yang dikelompokkan berdasarkan situasi pemakaiannya — peta jalan ringkas seluruh Course ini:

Baris penutup keluaran juga menyebut dua variasi berguna: git help -a mencantumkan seluruh subperintah yang tersedia, dan git help -g mencantumkan panduan konsep. Dokumentasi lengkap sistem bantuannya ada di https://git-scm.com/docs/git-help .

Membuka Manual Perintah #

Perintah git help <perintah> membuka manual lengkap untuk satu perintah — misalnya git help commit membuka manual git commit. Tanpa argumen khusus, git help git membuka manual Git itu sendiri: sebuah dokumen panjang yang dibuka melalui program pembaca manual (pager), digulir dengan tombol spasi, dicari dengan /kata-kunci, dan ditutup dengan tombol q.

Pada mesin uji Course yang berupa kontainer minimal, program pembaca manual tidak terpasang, sehingga Git melaporkannya seperti berikut:

Output yang Dihasilkan:

warning: failed to exec 'man': No such file or directory
fatal: no man viewer handled the request

Bila Perintah Tidak Dikenali #

Jika pemeriksaan pertama dijawab pesan seperti bash: git: command not found, shell tidak menemukan biner git di PATH mana pun. Tiga penyebab paling umum, urut dari yang termudah:

• Terminal dibuka sebelum instalasi selesai. PATH dimuat saat shell dimulai, jadi terminal lama tidak melihat program yang baru dipasang. Tutup dan buka ulang terminal, lalu ulangi git --version.
• Git memang belum terpasang. Kembali ke chapter instalasi sesuai sistem operasi: Linux , Windows , macOS , atau WSL .
• PATH tidak memuat Git di Windows. Jika pilihan wizard PATH adalah “Use Git from Git Bash only”, git hanya dikenal di Git Bash. Jalankan perintah dari Git Bash, atau jalankan ulang penginstal dan pilih “Git from the command line and also from 3rd-party software”.

Tiga pemeriksaan yang lolos berarti Git siap dipakai. Namun ada satu pengaturan yang belum boleh dilewati: setiap commit mencatat nama dan email pembuatnya, dan Git menolak bekerja tanpa keduanya. Chapter Konfigurasi Identitas mengisi pengaturan tersebut sekali untuk selamanya.