WindowsにDjangoをインストールする方法—Djangoのドキュメント

提供:Dev Guides
< DjangoDjango/docs/3.2.x/howto/windows
移動先:案内検索

WindowsにDjangoをインストールする方法

このドキュメントでは、WindowsにPython3.8とDjangoをインストールする方法について説明します。 また、仮想環境をセットアップするための手順も提供します。これにより、Pythonプロジェクトでの作業が簡単になります。 これは、Djangoプロジェクトで作業するユーザー向けの初心者向けガイドであり、Django自体のパッチを開発するときにDjangoをインストールする方法を反映していません。

このガイドの手順は、Windows10でテストされています。 他のバージョンでは、手順は同様です。 Windowsコマンドプロンプトの使用に精通している必要があります。

Pythonをインストールする

DjangoはPythonWebフレームワークであるため、Pythonをマシンにインストールする必要があります。 執筆時点では、Python3.8が最新バージョンです。

マシンにPythonをインストールするには、 https://www.python.org/downloads/にアクセスします。 Webサイトには、最新のPythonバージョンのダウンロードボタンが表示されます。 実行可能インストーラーをダウンロードして実行します。 「すべてのユーザーにランチャーをインストールする(推奨)」の横のチェックボックスをオンにして、「今すぐインストール」をクリックします。

インストール後、コマンドプロンプトを開き、Pythonのバージョンが次のコマンドを実行してインストールしたバージョンと一致することを確認します。

...\> py --version

も参照してください

詳細については、 python:using / windows のドキュメントを参照してください。


pipについて

pip はPythonのパッケージマネージャーであり、Pythonインストーラーにデフォルトで含まれています。 Pythonパッケージ(Django!など)のインストールとアンインストールに役立ちます。 残りのインストールでは、pipを使用して、コマンドラインからPythonパッケージをインストールします。


仮想環境のセットアップ

作成するDjangoプロジェクトごとに専用の環境を提供することをお勧めします。 Pythonエコシステム内の環境とパッケージを管理するための多くのオプションがあり、そのうちのいくつかは Pythonドキュメントで推奨されています。 Python自体には、このガイドで使用する環境を管理するための venv が付属しています。

プロジェクトの仮想環境を作成するには、新しいコマンドプロンプトを開き、プロジェクトを作成するフォルダーに移動して、次のように入力します。

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

これにより、「project-name」というフォルダーがまだ存在しない場合は作成され、仮想環境がセットアップされます。 環境をアクティブ化するには、以下を実行します。

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

仮想環境がアクティブになり、コマンドプロンプトの横に「(project-name)」と表示されてそれを指定します。 新しいコマンドプロンプトを開始するたびに、環境を再度アクティブ化する必要があります。


Djangoをインストールする

Djangoは、仮想環境内でpipを使用して簡単にインストールできます。

コマンドプロンプトで、仮想環境がアクティブであることを確認し、次のコマンドを実行します。

...\> py -m pip install Django

これにより、最新のDjangoリリースがダウンロードおよびインストールされます。

インストールが完了したら、コマンドプロンプトでdjango-admin --versionを実行して、Djangoのインストールを確認できます。

Djangoを使用したデータベースのインストールについては、データベースを実行するを参照してください。


カラー端子出力

バージョン3.2の新機能。


生活の質の機能は、端末に(モノクロではなく)色付きの出力を追加します。 最新の端末では、これはCMDとPowerShellの両方で機能するはずです。 何らかの理由でこれを無効にする必要がある場合は、環境変数 DJANGO_COLORSnocolorに設定します。

古いWindowsバージョン、またはレガシー端末では、構文の色付けを有効にするには、 colorama をインストールする必要があります。

...\> py -m pip install colorama

色設定の詳細については、構文の色付けを参照してください。


よくある落とし穴

  • django-adminがどの引数を指定してもヘルプテキストのみを表示する場合は、Windowsでのファイルの関連付けに問題がある可能性があります。 PATHでPythonスクリプトを実行するために設定された環境変数が複数あるかどうかを確認してください。 これは通常、複数のPythonバージョンがインストールされている場合に発生します。

  • プロキシの背後でインターネットに接続している場合は、コマンドpy -m pip install Djangoの実行に問題がある可能性があります。 コマンドプロンプトで、プロキシ構成の環境変数を次のように設定します。

    ...\> set http_proxy=http://username:password@proxyserver:proxyport
    ...\> set https_proxy=https://username:password@proxyserver:proxyport
  • 一般に、DjangoはUTF-8エンコーディングがI / Oに使用されることを前提としています。 システムが別のエンコーディングを使用するように設定されている場合、これにより問題が発生する可能性があります。 Pythonの最近のバージョンでは、UTF-8エンコーディングを強制するために、 PYTHONUTF8環境変数を設定できます。 Windows 10は、言語‣管理言語設定‣システム設定のシステムロケールUse Unicode UTF-8 for worldwide language supportをチェックすることにより、システム全体の設定も提供します。