Flaskがimportできない原因10選｜ModuleNotFoundErrorの解決法【VSCode対応】

python -m pip show Flask

python -c "import flask, sys; print(flask.__version__, sys.executable)"

python -m pip install -U pip setuptools wheel

import sys
import os
import subprocess


def run_cmd(cmd: str) -> str:
    """外部コマンドを実行して、標準出力を文字列で返す"""
    try:
        result = subprocess.run(
            cmd,
            stdout=subprocess.PIPE,
            stderr=subprocess.STDOUT,
            text=True,
            shell=True,
        )
        return result.stdout.strip()
    except Exception as e:
        return f"[コマンド実行に失敗しました: {e}]"


def print_section(title: str) -> None:
    print("\n" + "=" * 70)
    print(title)
    print("=" * 70)


def main() -> None:
    # --------------------------------------------------------------
    # 1. Python本体と仮想環境の情報（原因2,5,8あたりの手がかり）
    # --------------------------------------------------------------
    print_section("① 基本情報（Pythonと仮想環境）")
    print(f"Python実行ファイル : {sys.executable}")
    print(f"Pythonバージョン   : {sys.version.split()[0]}")

    is_venv = hasattr(sys, "base_prefix") and sys.base_prefix != sys.prefix
    print(f"仮想環境の使用      : {'はい（venvなど）' if is_venv else 'いいえ（グローバル環境）'}")
    print(f"sys.prefix          : {sys.prefix}")
    print(f"sys.base_prefix     : {getattr(sys, 'base_prefix', 'なし')}")

    # --------------------------------------------------------------
    # 2. ファイル名のチェック（原因4: flask.pyとの衝突）
    # --------------------------------------------------------------
    print_section("② ファイル名のチェック（原因4: flask.pyとの衝突）")
    filename = os.path.basename(__file__)
    print(f"この診断ファイル名 : {filename}")

    current_dir = os.path.dirname(os.path.abspath(__file__))
    current_dir_files = os.listdir(current_dir)

    if filename.lower() == "flask.py":
        print("NG: ファイル名が 'flask.py' になっています。別の名前に変更してください。")
        print("    （例）flask_diag.py / app.py など")
    else:
        print("OK: このファイル名は 'flask.py' ではありません。")

    if "flask.py" in current_dir_files and filename.lower() != "flask.py":
        print("注意: 同じフォルダ内に 'flask.py' という別ファイルが存在します。")
        print("      本物のFlaskライブラリではなく、そのファイルを読み込んでいる可能性があります。")

    # --------------------------------------------------------------
    # 3. import flask のテスト（原因1,2,3,5,7,8,9,10）
    # --------------------------------------------------------------
    print_section("③ import flask のテスト")
    imported_flask = False
    dependency_issue = False

    try:
        import flask  # noqa: F401

        imported_flask = True
        print("OK: import flask に成功しました。")

        try:
            # バージョンとモジュールの場所も表示
            print(f"flask のバージョン : {getattr(flask, '__version__', '不明')}")
            print(f"flask モジュールの場所 : {getattr(flask, '__file__', '不明')}")
        except Exception:
            pass

        try:
            from flask import Flask  # noqa: F401

            print("OK: from flask import Flask も成功しました。")
        except Exception as e:
            print("注意: from flask import Flask で例外が発生しました。")
            print(f"エラーの種類 : {type(e).__name__}")
            print(f"メッセージ   : {e}")
            print("→ コード側の書き方や依存パッケージを確認してください。")
    except Exception as e:
        print("NG: import flask に失敗しました。")
        print(f"エラーの種類 : {type(e).__name__}")
        print(f"メッセージ   : {e}")

        msg_lower = str(e).lower()
        for dep in ("werkzeug", "jinja2", "itsdangerous", "click"):
            if dep in msg_lower:
                dependency_issue = True
                break

        print("→ 原因1 / 原因2 / 原因3 / 原因5 / 原因7 / 原因8 / 原因9 / 原因10")
        print("   のいずれかに該当している可能性があります。")

    # --------------------------------------------------------------
    # 4. Flaskのインストール状況（原因1,2,5,7,8,10）
    # --------------------------------------------------------------
    print_section("④ Flaskのインストール状況（python -m pip / pip）")

    # 現在のPythonが見ている環境でのFlask
    show_current = run_cmd(f'"{sys.executable}" -m pip show Flask')
    print('[python -m pip show Flask] の結果：')
    print(show_current or "(出力なし)")

    # 単純な pip コマンドでのFlask
    show_pip = run_cmd("pip show Flask")
    print("\n[pip show Flask] の結果：")
    print(show_pip or "(出力なし)")

    installed_current = "Name: Flask" in show_current
    installed_pip = "Name: Flask" in show_pip

    if not installed_current and not installed_pip:
        print("\n→ 原因1: どの環境にもFlaskがインストールされていない可能性が高いです。")
    elif not installed_current and installed_pip:
        if is_venv:
            print("\n→ 原因2 / 原因5 / 原因8 / 原因10 が疑われます。")
            print("   ・この仮想環境とは別の環境にFlaskが入っている")
            print("   ・pipコマンドが別のPythonを参照している")
            print("   などの可能性があります。")
        else:
            print("\n→ 原因5 / 原因8:")
            print("   'pip' コマンドが、今このPythonとは別のPython環境に紐づいている可能性があります。")
            print("   必ず 'python -m pip install Flask' の形式でインストールしてみてください。")
    elif installed_current and not imported_flask:
        print("\n→ Flask自体は現在の環境にインストールされていますが、importに失敗しています。")
        print("   依存パッケージの不整合（原因7）や、環境の破損が疑われます。")
    else:
        print("\n→ 現在のPython環境にはFlaskがインストールされており、importも成功しています。")

    # --------------------------------------------------------------
    # 5. pipのバージョンと対応Python（原因5,7,8,9）
    # --------------------------------------------------------------
    print_section("⑤ pipのバージョンと対応Python（原因5,7,8,9）")

    pip_ver_current = run_cmd(f'"{sys.executable}" -m pip --version')
    print(f'[{sys.executable} -m pip --version] の結果：')
    print(pip_ver_current or "(出力なし)")

    pip_ver_cmd = run_cmd("pip --version")
    print("\n[pip --version] の結果：")
    print(pip_ver_cmd or "(出力なし)")

    print(
        "\n上の2つの出力に出てくる Python のバージョンやパスを見比べてください。\n"
        "・違っている場合 → 原因5（pipとpythonのズレ）や原因8（複数Pythonの混在）が疑われます。\n"
    )

    # --------------------------------------------------------------
    # 6. Python / pip の場所と sys.path（原因3,8,9,10）
    # --------------------------------------------------------------
    print_section("⑥ Python / pip の場所と import パス（原因3,8,9,10）")

    if os.name == "nt":
        py_paths = run_cmd("where python")
        pip_paths = run_cmd("where pip")
    else:
        py_paths = run_cmd("which -a python python3")
        pip_paths = run_cmd("which -a pip pip3")

    print("[python の場所候補]")
    print(py_paths or "(見つかりませんでした)")

    print("\n[pip の場所候補]")
    print(pip_paths or "(見つかりませんでした)")

    print(
        "\n上記に複数のパスが表示されている場合、複数のPythonが同居している可能性があります。\n"
        "VSCode右下のPythonインタープリタのパスと、ここに表示されているパスが一致しているか確認してください。\n"
    )

    print("【sys.path（Pythonがモジュールを探すパスの一覧）】")
    for p in sys.path:
        print("  -", p)

    print(
        "\n本番環境（Apache / mod_wsgi など）で使っている場合は、\n"
        "ここに仮想環境の site-packages パスが含まれているかどうかを確認してください。\n"
        "含まれていない場合は、原因9（本番環境でPATHが設定されていない）や\n"
        "原因10（プロジェクト独自のパス設定不足）の可能性があります。\n"
    )

    # --------------------------------------------------------------
    # 7. 推定される原因のまとめ
    # --------------------------------------------------------------
    print_section("⑦ 推定される原因のまとめ")

    if filename.lower() == "flask.py" or "flask.py" in current_dir_files:
        print("- 原因4: ファイル名やフォルダ名が 'flask.py' になっている可能性が高いです。")

    if not installed_current and not installed_pip:
        print("- 原因1: FlaskがどのPython環境にもインストールされていない可能性が高いです。")

    if not installed_current and installed_pip:
        if is_venv:
            print("- 原因2/5/8/10: 仮想環境とグローバル環境のインストール先がずれている可能性があります。")
        else:
            print("- 原因5/8: pipとpythonの参照先がずれている可能性があります。")

    if installed_current and not imported_flask:
        print("- 原因7: 依存パッケージの破損や不整合が疑われます。")
    if dependency_issue:
        print("- 原因7: エラーメッセージに依存パッケージ名が含まれているため、依存関係の不整合の可能性が高いです。")

    print(
        "\n※ Flaskのクラス名の大文字・小文字ミス（原因6）は、"
        "この診断コードからは直接検出できません。\n"
        "　ご自身のアプリコード側で `from flask import Flask` と書けているか、"
        "`flask` になっていないかを確認してください。\n"
    )

    print("詳しい直し方は、この記事の『Flaskがimportできない原因10選』の各項目を参照してください。")


if __name__ == "__main__":
    main()

python -m pip install Flask

.venv\Scripts\activate

rm -r __pycache__

where pip        # Windows
which pip        # Mac / Linux

from flask import Flask
app = Flask(__name__)

pip install -U "Flask[async]"

python -c "import sys; print(sys.executable)"

import sys
sys.path.insert(0, '/var/www/yourapp/.venv/lib/python3.11/site-packages')

import sys
sys.path.append('./src')

from flask import Flask

# Flaskアプリケーションのインスタンスを作成
app = Flask(__name__)

# ルートURL('/')にアクセスしたときに実行される関数
@app.route('/')
def hello():
    return "Hello, Flask!"

# アプリを起動（デバッグモード有効）
if __name__ == "__main__":
    app.run(debug=True)

python -m venv .venv

.venv\Scripts\activate
python -m pip install Flask

pip cache purge

python -m pip install Flask

python -m pip install Flask

python -c "import flask, sys; print(flask.__file__); print(sys.executable)"

python -m pip show Flask

python -m pip install Flask