Menyiapkan uv di macOS

Tujuan halaman ini #

Menginstal Python 3.13 dan uv di macOS Ventura / Sonoma
Membuat serta mengelola lingkungan virtual untuk proyek belajar
Memahami cara menghubungkan lingkungan tersebut dengan editor seperti VS Code

Prasyarat #

Item	Rincian
Alat wajib	Homebrew (`brew --version`). Jika belum ada, ikuti situs resmi
Shell	`zsh` (default) atau `bash`. Contoh di sini memakai `zsh`
Folder kerja	Contoh: `~/Projects/my-app` (silakan sesuaikan)

1. Instal Python 3.13 #

brew update
brew install python@3.13
brew link python@3.13
python3.13 --version

Jika muncul Python 3.13.x, instalasi berhasil. Bila versi lain sudah terhubung, jalankan brew unlink python@3.x lalu ulangi brew link.

2. Instal uv #

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version

Jika uv belum dikenali, tambahkan ~/.local/bin ke PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. Buat folder proyek dan lingkungan virtual #

mkdir -p ~/Projects/my-app
cd ~/Projects/my-app
uv venv --python 3.13 .venv
source .venv/bin/activate

Tanda (.venv) pada prompt berarti lingkungan aktif. Ketik deactivate untuk keluar.

庁 Tanpa aktivasi, kamu bisa menjalankan uv run python script.py; uv otomatis memakai lingkungan tersebut.

4. Tambah & sinkronkan pustaka #

uv pip install numpy pandas
uv pip list
uv pip sync requirements.txt

uv pip install: menambahkan paket
uv pip list: melihat paket yang terpasang
uv pip sync: menyelaraskan dengan isi requirements.txt

5. Integrasi dengan VS Code #

Buka VS Code 竊・Command Palette (竍ｧ竚榔) 竊・Python: Select Interpreter
Pilih .venv/bin/python agar interpreter lingkungan virtual terpakai
Rekomendasi ekstensi: Python, Pylance, Black Formatter, Flake8/Ruff

6. Masalah umum #

Masalah	Solusi
`command not found: brew`	Homebrew belum terpasang. Ikuti panduan resmi
`uv` tidak bisa dijalankan	Tambahkan PATH seperti di atas dan `source ~/.zshrc`
Tidak bisa membuat lingkungan	Periksa izin folder (`ls -ld .`, `chmod`, atau `chown` bila perlu)

7. Membersihkan #

Keluar dari lingkungan: deactivate
Hapus lingkungan: rm -rf .venv
Simpan daftar dependensi: uv pip freeze > requirements.txt

macOS kini siap dengan Python 3.13 + uv. Lihat juga panduan Windows dan Ubuntu untuk membandingkan langkah-langkahnya sebelum lanjut ke bab berikutnya.

Jika semuanya sudah siap, lanjutkan ke langkah berikutnya untuk mulai belajar Python.

Langkah selanjutnya: Mulai belajar Python