VS Code menyediakan editor dan menghubungkannya dengan interpreter serta alat Python. Tujuan penyiapan awal adalah sederhana: file dijalankan oleh Python yang benar, format konsisten, dan pesan error mudah ditemukan.

Tujuan Penggunaan

Gunakan panduan ini untuk menyiapkan proyek pertama atau memperbaiki ketidaksesuaian interpreter. Kamu akan memiliki satu folder proyek dengan venv, pengaturan editor secukupnya, dan program yang dapat dijalankan.

Persiapan

Ikuti instalasi Python pada Bab 2 dan pengenalan venv pada Bab 18. Pasang VS Code dari situs resmi. Pintasan di lampiran ini memakai keymap bawaan Windows; pada sistem atau keymap lain, cari nama perintah melalui Command Palette. Tidak perlu memasang seluruh ekstensi yang tersedia.

Panduan dan Contoh

Menyiapkan ekstensi dan folder

Buka panel Extensions. Periksa nama penerbit agar paket yang dipasang sesuai dengan panduan:

Beberapa ekstensi dapat terpasang sebagai dependensi. Pastikan semuanya yang diperlukan aktif. Formatter dan linter kini memakai ekstensi alat tersendiri; pengaturan lama python.formatting.* dan python.linting.* tidak dipakai lagi. Linter bersifat tambahan; pilih ketika dibutuhkan.

Buat folder latihan_vscode, lalu buka melalui File > Open Folder. Buka Terminal > New Terminal. Dari folder itu, buat venv:

python -m venv .venv

Buka Command Palette, jalankan Python: Select Interpreter, lalu pilih Python di .venv. Terminal baru dapat membantu menerapkan lingkungan yang dipilih. Jika aktivasi PowerShell tidak berjalan, kamu tetap dapat memanggil interpreter langsung tanpa mengubah kebijakan sistem:

.\.venv\Scripts\python.exe main.py

Pada macOS/Linux, bentuk setaranya adalah ./.venv/bin/python main.py. Buat main.py dari contoh di bawah sebelum menjalankan perintah tersebut.

Program untuk memeriksa lingkungan

import sys


def hitung_total(harga, jumlah):
    return harga * jumlah


print("Lingkungan virtual:", sys.prefix != sys.base_prefix)
print("Total:", hitung_total(12000, 3))

Lingkungan virtual: True
Total: 36000

Buka main.py dan gunakan Run Python File in Terminal. Perintah itu memakai integrasi Python. Jika keluaran tidak sesuai, periksa sys.executable dalam sesi interpreter untuk melihat jalur yang dipakai.

Pengaturan proyek yang dapat dibagikan

Simpan konfigurasi berikut pada .vscode/settings.json. Bentuknya JSON tanpa komentar sehingga juga dapat diperiksa dengan parser JSON biasa.

{
  "[python]": {
    "editor.defaultFormatter": "ms-python.black-formatter",
    "editor.formatOnSave": true,
    "editor.tabSize": 4,
    "editor.insertSpaces": true
  },
  "editor.rulers": [
    69
  ],
  "files.insertFinalNewline": true,
  "files.trimTrailingWhitespace": true,
  "black-formatter.args": [
    "--line-length",
    "69"
  ]
}

Black Formatter harus tersedia agar format saat menyimpan bekerja. Batas 69 mengikuti tata letak buku, bukan nilai bawaan PEP 8. Jika konfigurasi proyek sudah ada, gabungkan pengaturan yang diperlukan; hindari mengganti seluruh file dan menghilangkan pengaturan proyek lain.

Pengaturan user berlaku luas, sedangkan pengaturan workspace berlaku pada proyek yang dibuka. Preferences: Open Workspace Settings (JSON) membuka file proyek. Pilihan interpreter disetel melalui Python: Select Interpreter; tidak perlu menyalin python.pythonPath dari tutorial lama.

Menjalankan debugger dan membaca masalah

Gunakan Run and Debug untuk menjalankan debugger. Untuk pengaturan eksplisit, simpan .vscode/launch.json berikut:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: File Aktif",
      "type": "debugpy",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "cwd": "${workspaceFolder}",
      "justMyCode": true
    }
  ]
}

Tipe debugger Python yang dipakai adalah debugpy. Nilai program menunjuk file editor yang aktif; cwd menetapkan folder kerja proyek. Buka file Python, pasang breakpoint, kemudian jalankan konfigurasi Python: File Aktif. Lampiran 5 menjelaskan cara melangkah dan membaca nilai variabel.

Pengaturan tambahan sesuai kebutuhan

Tema, ikon, dan font dapat dipilih untuk kenyamanan membaca. Profiles memisahkan kumpulan pengaturan dan ekstensi; profil tidak menggantikan venv. Settings Sync membantu menyamakan pengaturan antar perangkat jika kamu memilih mengaktifkannya.

Gunakan Configure Snippets untuk membuat singkatan yang sering dipakai. Asisten AI bersifat opsional. Minta penjelasan, lalu periksa code dan hasilnya; langkah dasar di lampiran ini tidak membutuhkan layanan AI atau langganan.

Praktik Mandiri

L04-P01 – Jalankan dari venv proyek

Ekstrak paket contoh, buat .venv, pilih interpreter itu di VS Code, dan jalankan main.py. Ubah jumlah menjadi 4, simpan, lalu jalankan kembali.

Kriteria selesai: Program menampilkan Lingkungan virtual: True dan Total: 48000. File tetap terformat dengan indentasi empat spasi.

Rangkuman

Satu proyek memiliki folder dan interpreter yang jelas. Ekstensi Python, debugger, serta formatter memiliki peran berbeda. Mulai dari konfigurasi kecil yang kamu pahami, lalu tambahkan alat sesuai kebutuhan.

Referensi dan Materi Pendamping

• VS Code: tutorial Python
• VS Code: lingkungan Python
• VS Code: formatter Python
• VS Code: linting Python
• VS Code: pengaturan Python
• VS Code: Profiles
• Pendamping Lampiran 5

Edisi September 2026. Contoh dan nomor praktik sesuai dengan buku.

FAQ | Lampiran 1 | Lampiran 2 | Lampiran 3 | Lampiran 4 | Lampiran 5 | Lampiran 6 | Lampiran 7