Flask インストール
Flask アプリケーションの作成を始める前に、Python 環境を準備し、Flask をインストールする必要があります。
Flask のインストールは比較的簡単です。
Flask は Python のライブラリなので、まずコンピューターに Python がインストールされていることを確認する必要があります。
Python バージョン要件
Flask 3.x の要件Python 3.9 以上。
まだ Python をインストールしていない場合は、python.orgからダウンロードしてインストールしてください。
インストール完了後、ターミナルを開いて確認してください:
$ python3 --version Python 3.12.3 $ pip3 --version pip 24.0 from /usr/lib/python3.12/site-packages/pip (python 3.12)
macOS とほとんどの Linux ディストリビューションには Python 3 がプリインストールされています。Windows を使用している場合は、インストール時にAdd Python to PATHオプションにチェックを入れてください。
仮想環境
仮想環境(Virtual Environment)は Python プロジェクトの標準的な方法で、プロジェクトごとに独立した Python パッケージスペースを作成します。
仮想環境を使う理由
2つのプロジェクトがあるとします:プロジェクト A には Flask 3.0 が必要で、プロジェクト B には Flask 2.3 が必要です。
グローバルにインストールすると、2つのバージョンの Flask が互いに競合します。
仮想環境により、各プロジェクトは独立した依存パッケージを持ち、互いに干渉しません。
Python に組み込みのvenvモジュールで仮想環境を作成でき、追加ツールのインストールは不要です。
仮想環境の作成
まずプロジェクトディレクトリを作成し、その中に仮想環境を作成します:
$ mkdir サンプル-flask-test $ cd サンプル-flask-test $ python3 -m venv .venv
.venvは仮想環境のディレクトリ名です。好きな名前に変更できますが、.venvがコミュニティで最も一般的な慣例です。
仮想環境のアクティブ化
| オペレーティングシステム | アクティブ化コマンド |
|---|---|
| macOS / Linux | . .venv/bin/activate 或 source .venv/bin/activate |
| Windows (CMD) | .venv\Scripts\activate |
| Windows (PowerShell) | .venv\Scripts\Activate.ps1 |
アクティブ化に成功すると、ターミナルのプロンプトの前に(.venv)という識別表示が現れ、仮想環境が有効であることを示します。
$ . .venv/bin/activate (.venv) $ # <-- 提示符变了,说明虚拟环境已经激活
仮想環境の終了
開発完了後、deactivateコマンドで終了します:
(.venv) $ deactivate $
新しいターミナルウィンドウを開くたびに、Flask を使用するには仮想環境を再度アクティブ化する必要があります。
また、Python パッケージと環境管理ツールである uv を使用することもできます。参照:https://www.example.com/python3/uv-tutorial.html
# 使用指定 Python 版本创建虚拟环境 uv venv --python 3.12 激活虚拟环境: # macOS / Linux source .venv/bin/activate # Windows(PowerShell) .venv\Scripts\activate
Flask のインストール
仮想環境がアクティブ化された状態で、pip を使用して Flask をインストールします:
(.venv) $ pip install Flask
インストール完了後、Flask が正常にインストールされたか確認します:
flask --version
出力は以下のような情報になります:
Python 3.9.6 Flask 3.0.0 Werkzeug 3.1.5
以下のコードで確認することもできます:
from importlib.metadata import version
flask_version = version("flask")
print(flask_version)
正常にインストールされると、以下のようなバージョン番号が出力されます:
3.1.3
このとき、以下の依存パッケージも一緒にインストールされます:Werkzeug、Jinja2、Click、itsdangerous、blinker。
オプション:python-dotenv のインストール
python-dotenvこれにより、.envと.flaskenvファイルで環境変数を管理でき、Flask コマンドの使用が簡素化されます:
(.venv) $ pip install python-dotenv
必須ではありませんが、実際の開発では強く推奨されます。毎回--appパラメータを入力する手間が省け、チームで環境設定を共有するのにも便利です。
プロジェクトディレクトリ構造
コーディングを始める前に、標準的な Flask プロジェクトのディレクトリ構造を理解しておくと役立ちます:
myflaskapp/ ├── .venv/ # 虚拟环境(不要提交到 Git) ├── app.py # 应用入口文件 ├── templates/ # Jinja2 模板文件目录 ├── static/ # CSS、JS、图片等静态文件目录 ├── .flaskenv # Flask 环境变量(可选) └── .gitignore # 忽略 .venv 等不需要提交的文件
仮想環境ディレクトリ.venvGit にコミットすべきではありません。.gitignoreに.venv/を追加するだけです。
開発環境
開発環境のおすすめ:
中国国内の Alibaba と ByteDance も VS Code ベースの AI IDE を開発しています:
オンライン AI アプリ生成・開発プラットフォーム:
その他の拡張