Bagaimana memasang Django pada WIndows

Dokumen ini akan membimbing anda dalam memasang Python 3.13 dan Django di Windows. Dokumen ini juga menyediakan petunjuk untuk memasanglingkungan maya, yang membuatnya lebih mudah untuk mengerjakan proyek Python. Ini artinya sebagai panduan pemula untuk pengguna bekerja pada proyek Django dan tidak mencerminkan bagaimana Django harus dipasang ketika mengembangkan perubahan untuk Django itu sendiri.

Langkah-langkah dalam panduan ini telah diuji dengan Windows 10. Di versi lainnya, langkah-langkah akan mirip. Anda harus terbiasa dengan dengan menggunakan perintah prompt Windows.

Pasang Phyton

Django adalah kerangka kerja jaringan Python, demikian membutuhkan Python untuk dipasang pada mesin anda. Pada waktu penulisan, Python 3.13 adalah versi terakhir.

Untuk memasang Python di mesin anda pergi ke https://www.python.org/downloads/. Situs tersebut kemudian akan menawarkan tombol unduh untuk versi Python terbaru. Unduh berkas pemasang dijalankan dan jalankan. Centang kotak "Install launcher for all users (recommended)" dan klik "Install Now".

Setelah pemasangan, buka command prompt dan periksa bahwa versi Python cocok dengan versi anda pasang dengan menjalankan:

...\> py --version

py tidak dikenali atau ditemukan

Bergantung pada bagaimana anda memasang Python (seperti melalui Microsoft Store), py mungkin tidak tersedia di prompt perintah.

Anda akan butuh menggunakan``python`` daripada py ketika memasukkan perintah.

Lihat juga

Untuk rincian lebih,lihat dokumentasi Using Python on Windows.

Tentang pip

pip adalah pengelola paket untuk Python dan termasuk dalam awalan dengan pemasang Python. Itu membantu memasang dan melepas paket Python (seperti Django!). Untuk sisa dari pemasangan, kami akan menggunakan pip untuk memasang paket Python dari baris perintah.

Menyetel lingkungan maya

Adalah praktik terbaik untuk menyediakan lingkungan berdedikasi untuk setiap proyek Django anda buat. Ada banyak pilihan untuk mengelola lingkungan dan paket dalam ekosistem Python, beberapa yang dianjurkan di Python documentation. Python itu sendiri datang dengan venv untuk mengelola lingkungan dimana penggunakan akan menggunakan panduan ini.

Untuk membuat lingkungan maya untuk proyek anda, buka prompt perintah baru, arahkan ke folder dimana anda ingin buat proyek anda dan masukkan berikut:

...\> py -m venv project-name

Ini akan membuat sebuah folder disebut 'project-name' jika belum ada dan menyetel lingkungan maya. Untuk mengaktifkan lingkungan, jalankan:

...\> project-name\Scripts\activate.bat

Lingkungan maya akan diaktifkan dan anda akan melihat "(project-name)" dekat dengan command prompt untuk menandai itu. Setiap waktu anda memulai command prompt baru, anda akan butuh mengaktifkan lingkungan kembali.

Pasang Django

Django dapat dipasang dengan mudah menggunakan pip dalam lingkungan maya anda.

Dalam prompt perintah, pastikan anda memasukkan lingkungan maya aktif, dan menjalankan perintah berikut:

...\> py -m pip install Django

Ini akan mengunduh dan memasang terbitan Django terakhir.

Setelah pemasangan lengkap, anda dapat memeriksa pemasangan Django anda dengan menjalankan django-admin --version di command prompt.

Lihat Dapatkan basisdata anda berjalan untuk informasi pada pemasangan basisdata dengan Django.

Keluaran terminal bewarna

Fitur kualitas-hidup menambahkan keluaran bewarna (daripada satu warna) ke terminal. Dalam terminal moderen ini juga bekerja untuk kedua CMD dan PowerShell. Jika beberapa alasan kebutuhan ini butuh ditiadakan, setel variabel lingkungan DJANGO_COLORS menjadi nocolor.

Pada versi Windows lama, atau warisan terminal, colorama 0.4.6+ harus dipasang untuk mengadakan pewarnaan sintaksis:

...\> py -m pip install "colorama >= 0.4.6"

Lihat Pewarnaan sintaksis untuk informasi lebih pada pengaturan warna.

Kesalahan umum

• Jika django-admin hanya menampilkan teks bantuan tidak perduli argumen apa yang diberikan, ada kemungkinan masalah dengan berkas terkait di Windows. Periksa jika ada lagi dari satu kumpulan lingkungan variabel untuk menjalankan tulisan Python dalam PATH. Ini biasanya muncul ketika ada lebih dari satu versi Python terpasang.

• Jika Anda terhubung ke internet menggunakan proksi, mungkin akan muncul masalah ketika menjalankan py -m pip install Django. Atur variabel environment untuk konfigurasi proksi dalam terminal sebagai berikut:

  ...\> set http_proxy=http://username:password@proxyserver:proxyport
  ...\> set https_proxy=https://username:password@proxyserver:proxyport
  

• Secara umum, Django beranggapan bahwa penyandian UTF-8 digunakan untuk I/O. Ini mungkin menyebabkan masalah jika sistem anda disetel menggunakan penyandian berbeda. Versi terbaru Python mengizinkan menyetel variabel lingkungan the PYTHONUTF8 untuk memaksa penyandian UTF-8. Windows 10 juga menyediakan pengaturqan lebar-sistem dengen memilih Use Unicode UTF-8 for worldwide language support di Language ‣ Administrative Language Settings ‣ Change system locale dalam pengaturan sistem.