Cara Membuat Virtual Environment Python dengan Venv

Virtual environment Python menggunakan modul venv adalah direktori mandiri yang memuat instalasi Python tertentu serta sejumlah paket tambahan yang terisolasi dari sistem utama. Modul ini disertakan secara otomatis pada instalasi standar Python versi 3.3 ke atas, sehingga pengembang tidak perlu memasang pustaka pihak ketiga tambahan seperti virtualenv untuk kebutuhan dasar isolasi dependensi.

Langkah Pembuatan Virtual Environment

Proses pembuatan lingkungan virtual memerlukan akses terminal atau command prompt pada sistem operasi yang digunakan. Pastikan versi Python telah terinstal dengan menjalankan perintah python --version atau python3 --version pada terminal.

1. Masuk ke Direktori Proyek

Buka terminal, lalu arahkan direktori kerja ke folder tempat proyek Python akan dikerjakan menggunakan perintah cd:

cd /jalur/ke/direktori/proyek

2. Eksekusi Perintah Pembuatan Venv

Jalankan perintah pembuatan lingkungan virtual. Umumnya, nama folder lingkungan virtual disepakati menggunakan nama venv atau .venv.

python -m venv venv

Pada sistem operasi berbasis Linux atau macOS, jika perintah python merujuk ke versi 2, gunakan python3 -m venv venv.

Aktivasi Virtual Environment

Sebelum memasang pustaka atau menjalankan skrip, lingkungan virtual wajib diaktifkan terlebih dahulu agar interpreter Python membaca dependensi lokal daripada sistem global.

Manajemen Paket dan Dependensi

Setelah status terminal menunjukkan nama lingkungan virtual dalam tanda kurung (contoh: (venv) user@computer:~$), setiap instalasi pustaka menggunakan pip akan masuk ke dalam folder isolasi tersebut tanpa mengganggu pustaka global sistem.

Menyimpan Daftar Dependensi

Untuk mencatat seluruh pustaka yang terinstal ke dalam sebuah berkas teks agar dapat direplikasi pada komputer lain, gunakan perintah:

pip freeze > requirements.txt

Memasang Dependensi dari Berkas

Jika ingin memasang kembali seluruh pustaka berdasarkan berkas konfigurasi yang sudah ada pada proyek lain, jalankan:

pip install -r requirements.txt

Troubleshooting Kendala Umum

Kendala yang sering ditemui pada sistem Windows adalah pembatasan eksekusi skrip (Script Execution Policy) pada PowerShell. Jika muncul pesan kesalahan bahwa skrip tidak dapat dijalankan, ubah policy PowerShell dengan hak akses Administrator menggunakan perintah:

Set-ExecutionPolicy Unrestricted -Scope CurrentUser

Selain itu, pastikan modul python3-venv telah terpasang pada distribusi Linux seperti Ubuntu atau Debian dengan menjalankan sudo apt install python3-venv sebelum membuat lingkungan virtual.