Memecahkan Masalah Instalasi

Masalah instalasi adalah tembok pertama yang menghentikan banyak pemula — sering kali bukan karena instalasinya sulit, tetapi karena pesan errornya terasa seperti bahasa asing. Kabar baiknya: hampir semua kegagalan instalasi Python berasal dari empat akar masalah yang sama. Pada Chapter penutup section ini kita pelajari tabel diagnosis cepatnya, lalu tiga teknik penelusuran yang menjadi kunci pengurai masalah.

Tabel Diagnosis Cepat #

Memahami PATH: Akar Sebagian Besar Masalah #

Ketika kita mengetik python3, shell mencari program bernama python3 di daftar folder bernama PATH — environment variable berisi deretan lokasi, dipindai dari kiri ke kanan, berhenti di temuan pertama. Dua kegagalan paling umum berasal dari mekanisme ini:

1. Folder Python tidak ada di PATH — shell tidak menemukan program sama sekali. Pada Windows inilah asal usul pesan 'python' is not recognized; pada macOS/Linux berbentuk command not found, contoh nyatanya bila kita salah mengetik nama program:

   text Salin

   $ python99 --version
   bash: python99: command not found

   Teks pesan tersebut mengikuti shell yang dipakai: zsh di macOS menampilkan zsh: command not found: python99, dan PowerShell menampilkan pesan serupa dengan nama python99 di dalamnya.

2. Ada program serupa lebih dulu di PATH — shell menemukan python yang bukan milik instalasi kita. Ini sebabnya satu mesin bisa punya banyak Python tanpa kita sadar: bawaan sistem, installer python.org, package manager, dan virtual environment masing-masing menyimpan salinannya.

Cara memperbaiki PATH per sistem operasi:

Konflik Versi: Python yang Mana yang Sedang Dipakai #

Ketika terpasang lebih dari satu versi, dua pertanyaan menjadi kunci: versi berapa dan lokasi mana. Di macOS dan Linux, perintah which menjawab keduanya:

$ which python3
/usr/local/bin/python3
$ which -a python3
/usr/local/bin/python3
/usr/bin/python3

Perintah which python3 menunjuk program yang aktif dipakai shell; which -a python3 menampilkan semua kandidat dalam urutan PATH. Pada contoh di atas ada dua python3: instalasi python.org di /usr/local/bin/python3 menang atas python3 bawaan sistem di /usr/bin/python3. Di Windows, perintah where python berperan sama, dan py -0 mendaftar seluruh versi yang dikenal py launcher.

Untuk memakai versi tertentu secara eksplisit, sebut langsung jalurnya (/usr/local/bin/python3 program.py) atau, di Windows, pakai py launcher dengan nomor versi: py -3.12 program.py. Di macOS, keterangan khusus: /usr/bin/python3 adalah milik sistem operasi dan sebaiknya dibiarkan — pasang versi belajar kita dari python.org dan biarkan keduanya berdampingan.

Kapan Wajib Mencurigai Instalasi Itu Sendiri #

Tiga tanda bahwa masalahnya ada pada instalasi, bukan pada kode kita:

• Perintah python3 --version gagal atau menampilkan versi tak terduga — instalasi atau PATH bermasalah.
• Program yang tadinya berjalan mendadak berhenti setelah memasang Python baru — urutan PATH berubah.
• pip install berhasil tetapi import tetap gagal — package terpasang di interpreter yang berbeda dari yang menjalankan kode; verifikasi dengan python3 -m pip install nama_package agar keduanya pasti satu interpreter.

Empat akar masalah — PATH, penamaan perintah, konflik versi, dan interpreter campuran — kini punya prosedur penanganan masing-masing. Dengan instalasi yang sehat dan terminal yang patuh, fondasi kerja kita tuntas; section berikutnya kita akhirnya menulis program Python pertama yang utuh.