Tujuan halaman ini #
- Menginstal Python 3.13 di Windows 11 / 10
- Membuat dan mengelola lingkungan virtual dengan
uvdanvenv - Mengetahui masalah umum beserta solusinya
Prasyarat #
| Item | Detail |
|---|---|
| Hak akses | Pengguna biasa sudah cukup (Set-ExecutionPolicy hanya dipakai sementara) |
| Shell | Windows PowerShell (cari “PowerShell” di menu Start) |
| Folder kerja | Contoh yang dipakai: C:\projects\my-app (boleh diganti) |
1. Instal Python 3.13 #
Unduh
Windows installer (64-bit)dari situs resmiJalankan installer dan centang “Add python.exe to PATH” → klik
Install NowVerifikasi versinya di PowerShell
py -3.13 --versionJika muncul
Python 3.13.x, instalasi berhasil. Bilapytidak dikenali, tutup lalu buka kembali PowerShell.
💡 Kamu juga bisa memakai
winget install Python.Python.3.13, tetapi pastikan ulang PATH setelahnya.
2. Instal uv #
uv adalah manajer paket yang cepat. Jalankan perintah berikut di PowerShell:
Set-ExecutionPolicy -Scope Process Bypass
iwr https://astral.sh/uv/install.ps1 -UseBasicParsing | iex
uv --version
Jika versi ditampilkan, instalasi sukses. Jika tidak, buka ulang PowerShell atau pastikan $Env:USERPROFILE\.local\bin ada di PATH.
3. Buat folder proyek dan lingkungan virtual #
mkdir C:\projects\my-app
cd C:\projects\my-app
uv venv --python 3.13 .venv
Perintah ini membuat folder .venv. Aktifkan dengan:
.\.venv\Scripts\Activate.ps1
Saat prompt menampilkan (.venv), lingkungan aktif. Ketik deactivate untuk keluar.
✅ Kamu juga bisa langsung menjalankan perintah tanpa aktivasi:
uv run python script.pyotomatis memakai lingkungan tersebut.
4. Kelola pustaka #
uv pip install numpy pandas
uv pip list
uv pip sync requirements.txt
uv pip install: menambah pustakauv pip list: melihat daftar pustakauv pip sync: menyamakan lingkungan denganrequirements.txt
5. Konfigurasi Visual Studio Code (opsional) #
- Buka VS Code dan pilih interpreter Python di status bar
- Arahkan ke
.venv\Scripts\python.exeagar autocompletion dan debugging mengikuti lingkungan - Pasang ekstensi seperti “Python”, “Pylance”, atau “Black Formatter” untuk alur kerja lebih nyaman
6. Masalah umum dan solusinya #
| Masalah | Solusi |
|---|---|
Set-ExecutionPolicy ditolak | Tanyakan ke administrator atau jalankan PowerShell “Run as administrator” |
Perintah uv tidak ditemukan | Buka ulang PowerShell / tambahkan $Env:USERPROFILE\.local\bin ke PATH |
.venv tidak bisa dihapus | Pastikan VS Code atau aplikasi lain tidak sedang menggunakannya, lalu restart dan hapus |
7. Bersih-bersih #
- Keluar dari lingkungan:
deactivate - Hapus lingkungan: hapus folder
.venv - Simpan daftar pustaka:
uv pip freeze > requirements.txt
Sekarang Python 3.13 + uv siap dipakai di Windows. Lanjutkan dengan panduan OS lain bila perlu:
Jika semuanya sudah siap, lanjutkan ke langkah berikutnya untuk mulai belajar Python.