Panduan lengkap untuk menginstal Python, mengonfigurasi Visual Studio Code, dan memastikan program Python dapat dijalankan dengan baik di Windows.
Repository ini dibuat untuk membantu pemula mempersiapkan lingkungan pengembangan Python dari awal, mulai dari proses instalasi hingga menjalankan dan menguji program Python pertama di Visual Studio Code.
Seluruh tahapan dijelaskan secara berurutan agar mudah diikuti, bahkan bagi pengguna yang belum pernah menggunakan Python sebelumnya.
- Tentang Repository
- Tujuan
- Persiapan
- 1. Instalasi Python
- 2. Memeriksa Instalasi Python
- 3. Instalasi Visual Studio Code
- 4. Instalasi Python Extension
- 5. Membuat Folder Proyek
- 6. Memilih Python Interpreter
- 7. Menjalankan Program Python Pertama
- 8. Menguji Input dan Output
- 9. Menguji Debugging Python
- 10. Menggunakan Virtual Environment
- 11. Menguji Instalasi pip
- 12. Troubleshooting
- Checklist Instalasi
- Referensi Resmi
- Lisensi
Python merupakan bahasa pemrograman yang banyak digunakan dalam pengembangan aplikasi, otomatisasi, analisis data, kecerdasan buatan, dan berbagai kebutuhan lainnya.
Sebelum mulai mengembangkan program menggunakan Python, kita perlu menyiapkan lingkungan pengembangan yang sesuai.
Repository ini berfokus pada proses setup Python menggunakan Visual Studio Code (VS Code), mulai dari instalasi perangkat lunak hingga pengujian program untuk memastikan seluruh konfigurasi berjalan dengan benar.
Repository ini bertujuan untuk:
- Membantu pengguna menginstal Python di Windows.
- Membantu pengguna menginstal Visual Studio Code.
- Menjelaskan cara memasang Python Extension.
- Menjelaskan cara memilih Python Interpreter.
- Menjelaskan cara menjalankan program Python melalui terminal VS Code.
- Memberikan contoh kode untuk menguji instalasi Python.
- Memperkenalkan virtual environment untuk mengisolasi dependensi proyek.
- Membantu pengguna mengatasi masalah umum saat menjalankan Python.
Panduan ini ditujukan untuk:
- Pemula yang baru mengenal Python.
- Mahasiswa yang ingin menyiapkan lingkungan pemrograman Python.
- Pengguna yang ingin menjalankan Python melalui VS Code.
- Siapa pun yang membutuhkan panduan instalasi Python di Windows.
Panduan ini menggunakan Windows 10 dan Windows 11 sebagai lingkungan utama.
Nama menu atau tampilan installer mungkin berbeda tergantung versi perangkat lunak yang digunakan.
Sebelum memulai instalasi, pastikan perangkat memenuhi kebutuhan berikut.
| Kebutuhan | Keterangan |
|---|---|
| Sistem Operasi | Windows 10 atau Windows 11 yang masih didukung |
| Python | Python 3 versi stabil |
| Code Editor | Visual Studio Code |
| Extension | Python dari Microsoft |
| Koneksi Internet | Dibutuhkan untuk mengunduh perangkat lunak |
| Terminal | Command Prompt, PowerShell, atau terminal VS Code |
Tidak diperlukan instalasi database, framework, atau perangkat lunak tambahan lainnya untuk mengikuti pengujian dasar dalam panduan ini.
Python perlu diinstal terlebih dahulu agar komputer dapat menjalankan program Python.
Buka halaman download resmi Python melalui tautan berikut:
🔗 https://www.python.org/downloads/
Ikuti langkah-langkah berikut:
- Buka halaman download Python.
- Pilih versi Python 3 stabil yang tersedia.
- Download installer yang sesuai untuk Windows.
- Tunggu hingga proses download selesai.
- Buka file installer yang sudah diunduh.
Gunakan installer dari situs resmi Python untuk menghindari file instalasi yang tidak tepercaya.
Jalankan installer yang sudah diunduh.
Jika installer menampilkan opsi Add python.exe to PATH, aktifkan opsi tersebut sebelum melanjutkan instalasi.
Selanjutnya:
- Aktifkan opsi
Add python.exe to PATHjika tersedia. - Klik
Install Nowjika opsi tersebut tersedia. - Tunggu hingga proses instalasi selesai.
- Jika muncul notifikasi instalasi berhasil, tutup installer.
Catatan: Tampilan installer dapat berbeda antarversi Python. Ikuti petunjuk yang ditampilkan oleh installer versi yang digunakan.
Opsi Add python.exe to PATH membantu Windows menemukan executable Python ketika perintah python dipanggil melalui terminal.
Jika opsi tersebut tidak tersedia atau terlewat, Python masih bisa digunakan melalui Python Launcher atau interpreter yang dipilih langsung di VS Code, bergantung pada konfigurasi instalasinya.
Setelah instalasi selesai, buka Command Prompt atau PowerShell.
Tekan Windows + R, ketik:
cmd
Kemudian tekan Enter.
Terminal Command Prompt akan terbuka.
Lanjutkan ke tahap berikutnya untuk memeriksa apakah Python berhasil diinstal.
Tahap ini digunakan untuk memastikan Python dapat ditemukan dan dijalankan oleh Windows.
Di Command Prompt, jalankan:
python --versionContoh hasil:
Python 3.x.x
Angka 3.x.x merupakan contoh format versi. Versi yang ditampilkan akan mengikuti versi Python yang terinstal.
Jika perintah tersebut tidak dikenali, coba:
py --versionContoh hasil:
Python 3.x.x
Perintah py menggunakan Python Launcher di Windows jika komponen tersebut tersedia.
Jalankan:
python -c "import sys; print(sys.executable)"Contoh hasil:
C:\Users\User\AppData\Local\Programs\Python\Python3xx\python.exe
Lokasi tersebut hanya contoh. Hasil aktual bergantung pada lokasi instalasi Python di komputer.
Perintah ini membantu memastikan executable Python yang digunakan oleh perintah python.
Jika kamu menggunakan Python Launcher, kamu juga bisa menjalankan:
py -c "import sys; print(sys.executable)"Jalankan perintah:
python -c "print('Python berhasil dijalankan!')"Jika perintah tersebut berhasil, hasilnya:
Python berhasil dijalankan!
Jika perintah python tidak tersedia tetapi py berfungsi, gunakan:
py -c "print('Python berhasil dijalankan!')"Kesimpulan tahap ini:
Jika versi Python dapat ditampilkan dan perintah untuk menjalankan kode berhasil, interpreter Python dapat dijalankan melalui terminal Windows.
Visual Studio Code merupakan code editor yang dapat digunakan untuk menulis, menjalankan, dan melakukan debugging program Python.
Buka situs resmi Visual Studio Code:
🔗 https://code.visualstudio.com/download
Langkah-langkah:
- Buka halaman download.
- Pilih installer Windows yang sesuai.
- Download file instalasi.
- Jalankan installer.
- Ikuti petunjuk instalasi hingga selesai.
Pastikan kamu mengunduh Visual Studio Code, bukan Visual Studio IDE, karena keduanya merupakan produk yang berbeda.
Setelah installer terbuka:
- Setujui persyaratan lisensi.
- Pilih lokasi instalasi jika diperlukan.
- Ikuti petunjuk instalasi.
- Jika tersedia, kamu dapat mengaktifkan opsi penambahan VS Code ke menu konteks Windows agar folder atau file lebih mudah dibuka melalui VS Code.
- Selesaikan proses instalasi.
- Buka Visual Studio Code.
Nama dan pilihan pada installer dapat berbeda tergantung versi yang digunakan.
Jika Visual Studio Code berhasil terbuka dan menampilkan antarmuka editor, instalasi dasar telah selesai.
Pada tahap ini, VS Code belum tentu sudah dapat menjalankan Python karena kita masih perlu memasang extension dan memilih interpreter.
Python Extension membantu VS Code menyediakan fitur khusus untuk pengembangan Python.
Extension ini terpisah dari interpreter Python yang sudah diinstal sebelumnya.
-
Buka Visual Studio Code.
-
Klik menu
Extensionspada sidebar. -
Kamu juga dapat menggunakan shortcut:
Ctrl + Shift + X -
Pada kotak pencarian, ketik:
Python -
Pilih extension bernama Python yang diterbitkan oleh Microsoft.
-
Klik
Install.
Pastikan extension yang dipilih adalah extension Python dari Microsoft.
Python Extension menyediakan berbagai fitur, antara lain:
- Syntax highlighting.
- Code completion.
- Integrasi pemilihan Python Interpreter.
- Dukungan debugging.
- Integrasi dengan lingkungan pengembangan Python.
Beberapa fitur tambahan dapat membutuhkan extension atau komponen pendukung lainnya.
Penting: Python Extension tidak menggantikan instalasi Python. Jika interpreter belum terinstal, memasang extension saja tidak cukup untuk menjalankan program Python secara normal.
Setelah Python dan VS Code terinstal, kita akan membuat folder khusus untuk menguji konfigurasi.
Buat folder dengan nama:
uji-python
Kamu dapat membuatnya di Documents, Desktop, atau lokasi lain yang mudah ditemukan.
Contoh lokasi:
C:\Users\User\Documents\uji-python
Lokasi tersebut hanya contoh. Kamu bebas memilih direktori lain.
Ikuti langkah berikut:
- Buka Visual Studio Code.
- Pilih menu
File. - Klik
Open Folder. - Cari folder
uji-python. - Pilih folder tersebut.
- Klik
Select Folder.
Jika muncul dialog konfirmasi keamanan workspace, pastikan folder tersebut memang folder yang kamu buat sendiri sebelum mempercayainya.
Setelah folder terbuka, nama folder akan muncul pada panel Explorer.
Pilih menu:
Terminal → New Terminal
Atau gunakan shortcut:
Ctrl + Shift + `
Jika shortcut tersebut tidak sesuai dengan layout keyboard, gunakan menu Terminal.
Terminal akan muncul di bagian bawah VS Code.
Pastikan direktori aktif mengarah ke folder uji-python.
Kamu dapat memeriksanya melalui perintah:
Get-LocationPerintah tersebut berlaku pada PowerShell.
Jika menggunakan Command Prompt, jalankan:
cdHasilnya akan menunjukkan direktori aktif terminal.
Python Interpreter merupakan program Python yang digunakan untuk mengeksekusi kode.
Jika terdapat beberapa instalasi Python pada komputer, kita perlu memastikan VS Code menggunakan interpreter yang benar.
Ikuti langkah berikut:
-
Pastikan Python Extension dari Microsoft sudah terinstal.
-
Buka folder proyek
uji-python. -
Tekan
Ctrl + Shift + Puntuk membuka Command Palette. -
Ketik:
Python: Select Interpreter -
Pilih perintah tersebut.
-
Pilih interpreter Python 3 yang ingin digunakan.
Jika terdapat beberapa pilihan, periksa versi dan lokasi instalasinya.
Pilih instalasi Python yang sesuai dengan kebutuhanmu.
Jika Python tidak muncul dalam daftar:
- Pastikan Python sudah terinstal.
- Jalankan
python --versionataupy --versionmelalui terminal Windows. - Pastikan Python Extension dari Microsoft sudah terinstal dan aktif.
- Buka kembali Command Palette.
- Jalankan
Python: Select Interpretersekali lagi.
Jika masih tidak muncul, kamu mungkin perlu menggunakan opsi untuk memasukkan lokasi interpreter secara manual, jika tersedia pada versi extension yang digunakan.
Lokasi executable dapat diperiksa melalui:
python -c "import sys; print(sys.executable)"Atau, jika menggunakan Python Launcher:
py -c "import sys; print(sys.executable)"Gunakan lokasi executable yang benar-benar ditampilkan oleh komputermu.
Sekarang kita akan membuat program sederhana untuk memastikan Python dapat dijalankan melalui VS Code.
Pada panel Explorer:
-
Klik tombol
New File. -
Buat file bernama:
hello_world.py -
Masukkan kode berikut:
print("Hello, World!")
print("Python berhasil dijalankan melalui VS Code!")- Simpan file menggunakan
Ctrl + S.
Pastikan nama file berakhiran .py, bukan .txt.
Buka terminal VS Code.
Pastikan terminal berada pada folder yang berisi file hello_world.py.
Jalankan:
python hello_world.pyJika perintah python tidak tersedia, coba:
py hello_world.pyJika berhasil, hasilnya:
Hello, World!
Python berhasil dijalankan melalui VS Code!
Jika output muncul sesuai kode, berarti program berhasil dieksekusi.
Python Extension biasanya menyediakan pilihan untuk menjalankan file Python melalui tombol Run Python File in Terminal.
Langkah-langkah:
- Buka file
hello_world.py. - Cari tombol
Run Python File in Terminalpada area editor. - Klik tombol tersebut.
- Perhatikan terminal yang muncul di bagian bawah VS Code.
Jika konfigurasi sudah benar, output akan muncul di terminal.
Tombol ini menjalankan file menggunakan interpreter yang dipilih oleh extension.
Jika tombol tidak terlihat, kamu masih dapat menjalankan program secara manual melalui terminal seperti pada langkah sebelumnya.
Catatan: Menjalankan program melalui terminal merupakan cara yang baik untuk memeriksa apakah perintah Python berfungsi dan file yang dieksekusi sudah benar.
Setelah program pertama berhasil dijalankan, kita akan menguji apakah Python dapat menerima input dari pengguna dan menampilkan hasilnya.
Buat file baru bernama:
test_input.py
Masukkan kode berikut:
# Program untuk menguji input dan output Python
nama = input("Masukkan nama kamu: ")
print("Halo,", nama)
print("Input dan output Python berhasil digunakan!")Simpan file tersebut.
Jalankan melalui terminal VS Code:
python test_input.pyJika menggunakan Python Launcher:
py test_input.pyContoh interaksi:
Masukkan nama kamu: Ilham
Halo, Ilham
Input dan output Python berhasil digunakan!
Kamu dapat mengganti Ilham dengan nama apa pun.
Program ini menguji beberapa hal:
- Python dapat menjalankan file
.py. - Fungsi
input()dapat menerima masukan pengguna. - Fungsi
print()dapat menampilkan hasil. - Terminal dapat digunakan untuk berinteraksi dengan program.
Jika program berjalan dan menghasilkan output yang sesuai, pengujian input dan output berhasil.
Debugging merupakan proses memeriksa jalannya program untuk memahami perilakunya dan menemukan masalah.
VS Code menyediakan dukungan debugging Python melalui Python Extension.
Buat file:
test_debug.py
Masukkan kode berikut:
# Program sederhana untuk menguji debugging
nama = "Python"
pesan = "Debugging berhasil"
print(nama)
print(pesan)Simpan file tersebut.
Breakpoint digunakan untuk menghentikan sementara eksekusi program pada baris tertentu.
Langkah-langkah:
-
Buka file
test_debug.py. -
Klik area di sebelah kiri nomor baris pada baris:
print(pesan)
-
Titik merah akan muncul sebagai penanda breakpoint.
-
Buka menu
Run and Debugdi VS Code. -
Pilih opsi untuk menjalankan dan melakukan debugging pada file Python aktif, jika tersedia.
-
Jika diminta memilih konfigurasi, pilih konfigurasi Python yang sesuai.
Program akan berhenti sementara ketika mencapai breakpoint.
Pada saat berhenti, kamu dapat memeriksa variabel yang tersedia, melanjutkan eksekusi, atau menghentikan proses debugging.
Jika program berhasil berhenti pada breakpoint, dukungan debugging sudah berfungsi.
Catatan: Jika debugging belum dapat digunakan, pastikan Python Extension aktif dan interpreter sudah dipilih.
Virtual environment merupakan lingkungan Python terpisah yang digunakan untuk mengisolasi paket atau dependensi suatu proyek.
Fitur ini tidak wajib untuk menjalankan program Python sederhana. Namun, memahami cara membuatnya akan membantu ketika mulai menggunakan library tambahan.
Pastikan terminal VS Code berada di folder proyek uji-python.
Jalankan:
python -m venv .venvJika menggunakan Python Launcher:
py -m venv .venvPerintah tersebut membuat lingkungan virtual bernama .venv.
Jika berhasil, folder .venv akan dibuat di dalam proyek.
Struktur folder akan terlihat seperti berikut:
uji-python/
├── .venv/
├── hello_world.py
├── test_input.py
└── test_debug.py
Folder .venv berisi lingkungan Python dan komponen pendukungnya.
Folder tersebut biasanya tidak perlu dimasukkan ke repository Git.
Jika terminal VS Code menggunakan PowerShell, jalankan:
.\.venv\Scripts\Activate.ps1Jika berhasil, nama lingkungan virtual biasanya muncul pada awal prompt terminal.
Contohnya:
(.venv) PS C:\Users\User\Documents\uji-python>
Jika menggunakan Command Prompt, jalankan:
.venv\Scripts\activate.batPada beberapa konfigurasi Windows, PowerShell mungkin menolak menjalankan skrip aktivasi karena kebijakan eksekusi skrip.
Jika masalah ini terjadi, kamu dapat menggunakan Command Prompt untuk mengaktifkan virtual environment tanpa perlu mengubah kebijakan PowerShell.
Alternatif lainnya adalah menjalankan interpreter virtual environment secara langsung tanpa aktivasi.
Contoh pada PowerShell:
.\.venv\Scripts\python.exe --versionContoh pada Command Prompt:
.venv\Scripts\python.exe --versionKedua perintah tersebut menjalankan Python yang berada di dalam .venv.
Setelah .venv dibuat:
- Tekan
Ctrl + Shift + P. - Cari
Python: Select Interpreter. - Pilih interpreter yang berada di dalam folder
.venv.
Lokasinya biasanya menyerupai:
.venv\Scripts\python.exe
Lokasi aktual bergantung pada direktori proyek.
Setelah interpreter dipilih, VS Code akan menggunakan lingkungan tersebut untuk menjalankan program melalui integrasi Python.
Jalankan:
python --versionKemudian:
python -c "import sys; print(sys.executable)"Pastikan lokasi executable mengarah ke folder .venv.
Contoh:
C:\Users\User\Documents\uji-python\.venv\Scripts\python.exe
Jika lokasi tersebut muncul, interpreter virtual environment sedang digunakan oleh perintah python yang dijalankan.
pip merupakan alat yang umum digunakan untuk memasang dan mengelola paket Python.
Pada banyak instalasi Python, pip sudah tersedia. Namun, ketersediaannya tetap perlu diperiksa.
Jalankan:
python -m pip --versionJika menggunakan Python Launcher:
py -m pip --versionJika berhasil, terminal akan menampilkan versi pip dan lokasi instalasinya.
Contoh format output:
pip X.Y from ... (python 3.x)
Versi dan lokasi aktual akan berbeda sesuai lingkungan Python.
Jika kamu sudah membuat dan memilih .venv, jalankan:
python -m pip --versionPeriksa apakah lokasi pip mengarah ke lingkungan virtual yang sedang digunakan.
Untuk menjalankan pip, penggunaan python -m pip umumnya lebih jelas karena pip dipanggil melalui interpreter Python yang sedang dipilih.
Penting: Kamu tidak perlu memasang library tambahan hanya untuk memastikan Python berjalan. Pengujian menggunakan print(), input(), dan modul bawaan Python sudah cukup untuk memverifikasi fungsi dasar interpreter.
Bagian ini berisi beberapa masalah umum yang mungkin muncul ketika melakukan setup Python di Windows.
Contoh pesan:
'python' is not recognized as an internal or external command
Kemungkinan penyebab:
- Python belum terinstal.
- Python belum ditambahkan ke PATH.
- Terminal belum memuat perubahan konfigurasi terbaru.
- Windows menggunakan alias eksekusi aplikasi yang mengganggu pemanggilan Python.
Solusi:
-
Coba perintah:
py --version
-
Jika berhasil, gunakan
pyuntuk menjalankan program:py hello_world.py
-
Jika Python Launcher juga tidak tersedia, pastikan Python sudah terinstal.
-
Jika perlu, periksa kembali konfigurasi PATH.
-
Tutup dan buka kembali terminal setelah melakukan perubahan konfigurasi.
Jika Python belum terinstal dengan benar, jalankan kembali installer resmi Python dan ikuti petunjuk instalasinya.
Contoh pesan:
'py' is not recognized as an internal or external command
Hal ini tidak selalu berarti Python gagal diinstal.
Python Launcher mungkin tidak tersedia pada konfigurasi tersebut.
Coba:
python --versionJika python berfungsi, kamu dapat menggunakan perintah tersebut tanpa memerlukan py.
Jika keduanya tidak berfungsi, periksa instalasi Python dan konfigurasi PATH.
Solusi:
- Pastikan Python sudah terinstal.
- Pastikan Python Extension dari Microsoft sudah terinstal.
- Buka Command Palette.
- Jalankan
Python: Select Interpreter. - Pilih interpreter yang benar.
Jika interpreter tidak muncul, periksa lokasi executable melalui terminal dan pilih lokasi tersebut secara manual jika opsi yang tersedia mendukungnya.
Pastikan:
- Nama file berakhiran
.py. - File sudah disimpan.
- Terminal berada di direktori yang benar.
- Nama file yang diketik sesuai dengan nama file sebenarnya.
- Python Interpreter tersedia.
Contoh perintah:
python hello_world.pyJika terminal berada di direktori yang berbeda, pindah ke direktori proyek terlebih dahulu atau gunakan path file yang sesuai.
Periksa apakah:
- Kode sudah disimpan.
- Perintah yang dijalankan benar.
- File yang dieksekusi merupakan file yang sedang diedit.
- Program mengalami error sebelum mencapai perintah
print().
Untuk menguji interpreter secara langsung, jalankan:
python -c "print('Tes berhasil')"Jika output muncul, interpreter dapat mengeksekusi kode sederhana.
Pastikan:
- File yang dibuka memiliki ekstensi
.py. - Python Extension dari Microsoft sudah terinstal dan aktif.
- Folder proyek sudah dibuka di VS Code.
- Interpreter Python sudah dipilih.
Jika tombol Run tetap tidak muncul, jalankan program secara manual melalui terminal.
Contoh:
python hello_world.pyTombol Run bukan satu-satunya cara untuk menjalankan program Python.
Jika muncul pesan yang berkaitan dengan Execution Policy, kamu dapat menggunakan Command Prompt dan menjalankan:
.venv\Scripts\activate.batAlternatifnya, gunakan interpreter virtual environment secara langsung:
.\.venv\Scripts\python.exe --versionTidak perlu mengubah kebijakan keamanan PowerShell secara sembarangan hanya untuk mengaktifkan virtual environment.
Gunakan checklist berikut untuk memastikan setiap tahap telah diselesaikan.
- Python berhasil diinstal.
- Visual Studio Code berhasil diinstal.
- Python Extension dari Microsoft berhasil diinstal.
- Perintah
python --versionataupy --versionberhasil dijalankan. - Python Interpreter berhasil dipilih di VS Code.
- Folder proyek berhasil dibuka di VS Code.
- Terminal VS Code dapat digunakan.
- File
hello_world.pyberhasil dijalankan. - Output muncul di terminal.
- Program
test_input.pyberhasil menerima input. - Debugging berhasil diuji.
- Virtual environment berhasil dibuat.
- Interpreter
.venvberhasil digunakan. - Versi pip berhasil diperiksa jika pip tersedia.
Jika seluruh pengujian yang relevan berhasil, lingkungan pengembangan Python sudah siap digunakan untuk mulai belajar atau mengembangkan program Python.
Gunakan dokumentasi resmi berikut jika membutuhkan informasi lebih lanjut.
| Referensi | Tautan |
|---|---|
| Python Downloads | https://www.python.org/downloads/ |
| Python Documentation | https://docs.python.org/3/ |
| Python Tutorial | https://docs.python.org/3/tutorial/ |
| VS Code Downloads | https://code.visualstudio.com/download |
| Python in VS Code | https://code.visualstudio.com/docs/languages/python |
| VS Code Python Debugging | https://code.visualstudio.com/docs/python/debugging |
| Python Virtual Environments | https://docs.python.org/3/library/venv.html |
| pip Documentation | https://pip.pypa.io/en/stable/ |
Repository ini dapat menggunakan lisensi MIT agar materi dan contoh kode dapat dipelajari serta digunakan kembali sesuai ketentuan lisensi.
Jika menggunakan lisensi MIT, pastikan file LICENSE berisi teks lisensi MIT yang sesuai.
Terima kasih telah menggunakan Panduan Setup Python di Visual Studio Code.
Semoga panduan ini membantu proses instalasi, konfigurasi, dan pengujian Python agar berjalan dengan lancar.
Jika seluruh tahapan berhasil diselesaikan, kamu sudah memiliki lingkungan pengembangan Python yang siap digunakan untuk tahap pembelajaran berikutnya.
Happy Coding! 🚀🐍