根本原因是vscode未将项目识别为flask项目，路径、环境变量、启动方式三者未对齐；必须用"module":"flask"模式启动，配".env"文件声明flask_app，禁用--reload，并确保解释器、编码、断点位置正确。
VSCode 调试 Flask 时断点不生效、flask run 报 Could not locate a Flask application、改个代码就 reload 失败静默退出——这些问题根本不是 Flask 本身的问题，而是 VSCode 没把项目当“Flask 项目”来对待。关键在于：路径、环境变量、启动方式三者必须对齐，缺一不可。
为什么 flask run 在终端能跑，VSCode 里却报错？
因为 VSCode 默认不把项目根目录加进 Python 的 sys.path，FLASK_APP=app.py 就找不到这个模块。哪怕你 import flask 成功，flask CLI 也只在当前工作目录下搜 app.py 或 __init__.py。
- 必须用 File → Open Folder 打开整个项目文件夹，不能只打开
app.py - 项目根目录下必须有
app.py（或你指定的入口文件），且里面定义了app = Flask(__name__) - 不要手动
export FLASK_APP=...，VSCode 的调试器不读 shell 环境变量 - 推荐新建
.env文件（和app.py同级），写入：FLASK_APP=app.py<br>FLASK_DEBUG=1
（注意：Flask 2.3+ 已弃用FLASK_ENV）
launch.json 该用 program 还是 module？
必须用 "module": "flask"。用 program 直接运行 app.py 会绕过 Flask CLI，导致热重载失效、flask shell 不可用、路由调试不准——而且断点大概率不触发。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 正确配置核心字段：
"module": "flask""args": ["run", "--host=127.0.0.1:5000", "--no-reload"]"envFile": "${workspaceFolder}/.env" -
--no-reload是调试阶段刚需：Werkzeug 的自动重载会 fork 子进程，VSCode 默认只 attach 主进程，断点就丢了 - 如果用了工厂函数（如
create_app()），args改成：["--app", "app:create_app", "run", "--debug", "--no-reload"] - 别用插件自动生成的
Python: Flask配置，它硬编码FLASK_APP=app.py，换文件名就崩
断点打了但就是不进？检查这三处
断点失效不是玄学，基本就卡在这三个地方：
-
app.run()这行必须删掉——它和launch.json的flask run冲突，会导致双启动或静默失败 - VSCode 底部状态栏显示的 Python 解释器路径，必须指向你
venv里的python（比如./venv/bin/python），而不是系统 Python；按Ctrl+Shift+P→Python: Select Interpreter重新选 - 文件保存编码必须是
UTF-8 无 BOM：BOM 会导致 import 失败，Werkzeug reload 时直接退出，连错误都不报 - 断点只能打在路由函数内部（比如
@app.route("/")下面的函数体里），不能打在模块顶层——那里没有请求上下文，request对象压根不存在
依赖和虚拟环境最容易忽略的细节
很多问题表面是 Flask 报错，实际是环境没对齐。最常被跳过的验证步骤：
- 激活虚拟环境后，执行：
python -c "import flask; print(flask.__version__)"
确认输出版本号，而不是报ModuleNotFoundError -
pip list里必须有Flask和Werkzeug，版本最好固定（如Flask==2.3.2），避免新版默认禁用--debug导致调试异常 - 如果用 Poetry 或 Pipenv，解释器路径别选
python可执行文件本身，要选poetry run python对应的 wrapper（通常在.venv/bin/python） - Windows 用户注意：
.env文件不能有扩展名（即不能叫.env.txt），否则 VSCode 不识别
真正卡住人的，往往不是“怎么配”，而是“哪一步悄悄没生效”。比如 .env 文件名拼错、解释器选错虚拟环境、app.py 放错位置——这些地方没有报错提示，只有行为异常。每次改完配置，记得用 python -m flask --help 在终端里手动验证 CLI 是否能正常识别你的应用。
