按VS Code Flask教程创建Python应用失败，请求排查问题

算力阿峰

2026-7-8

Flask启动报错：Could not locate a Flask application 排查方案

问题背景

按照VS Code官方Flask应用创建教程操作，执行python -m flask run命令启动开发服务器时，出现以下错误：

python -m flask run
Usage: python -m flask run [OPTIONS]
Try 'python -m flask run --help' for help.

Error: Could not locate a Flask application. Use the 'flask --app' option, 'FLASK_APP' environment variable, or a 'wsgi.py' or 'app.py' file in the current directory.

预期正常输出应为：

(.venv) D:\py\hello_flask>python -m flask run
 * Environment: production
   WARNING: Do not use the development server in a production environment.
   Use a production WSGI server instead.
 * Debug mode: off
 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

附带编辑器侧边栏截图：
编辑器侧边栏截图，供排查问题参考

排查步骤

验证终端工作目录
确认终端当前路径与app.py所在目录一致（截图中app.py在hello_flask文件夹下）。若路径不符，执行命令切换：
```
cd D:\py\hello_flask
```
检查app.py核心代码
确保app.py内正确初始化Flask实例，示例代码如下：
```
from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello, World!'
```
缺少app = Flask(__name__)这一核心语句会导致Flask无法识别应用。
显式指定应用启动（临时验证/修复）
若目录和代码均无问题，尝试显式指定应用文件启动：
```
python -m flask --app app.py run
```
或通过环境变量指定（Windows cmd终端）：
```
set FLASK_APP=app.py
python -m flask run
```
Windows PowerShell环境：
```
$env:FLASK_APP = "app.py"
python -m flask run
```
确认虚拟环境已激活
教程使用虚拟环境（预期输出带有.venv前缀），检查终端开头是否有.venv标识。未激活则执行激活命令：
```
.\.venv\Scripts\activate
```
激活后再执行启动命令，避免全局与虚拟环境的依赖冲突。
检查Flask版本
执行flask --version查看当前版本，Flask 2.0+默认自动识别app.py/wsgi.py，若版本过低需升级：
```
pip install --upgrade flask
```