VSCode调试Flask必须用"module": "flask"而非"program": "app.py"，否则绕过Flask CLI导致热重载、flask shell、url_for()上下文失效且断点不触发；需配".env"文件（UTF-8无BOM、路径"${workspaceFolder}/.env"）、正确Python解释器及Open Folder打开项目。
VSCode调试Flask必须用"module": "flask"，不能用"program": "app.py"
直接运行app.py会跳过Flask CLI，热重载、flask shell、url_for()上下文全失效，断点也大概率不触发。只有"module": "flask"才等价于终端里执行python -m flask run。
常见错误现象：Working outside of application context、断点打了但程序根本不进、flask run在终端能跑，VSCode里报Could not locate a Flask application。
-
"module": "flask"是硬性要求，缺了它就不是Flask调试，只是普通Python脚本运行 -
"args"至少包含["run", "--host=127.0.0.1:5000"]，避免Windows防火墙拦截默认的localhost:5000 - 开发调试阶段务必加
--no-reload：Werkzeug重载会fork子进程，VSCode只attach主进程，断点就丢了 - 如果用工厂函数（如
create_app()），args得改成["--app", "app:create_app", "run", "--debug", "--no-reload"]
.env文件必须存在且路径写死为"${workspaceFolder}/.env"
VSCode调试器完全不读终端里的export FLASK_APP=app.py，只认envFile指定的文件。这个文件必须放在项目根目录（即app.py同级），编码为UTF-8无BOM。
常见错误现象：Could not locate a Flask application、ImportError找不到模块、明明有app.py却提示没定义app实例。
立即学习“Python免费学习笔记（深入）”；
-
envFile值只能是"${workspaceFolder}/.env"，写".env"或绝对路径都无效 -
.env内容示例（注意换行）：FLASK_APP=app.pyFLASK_DEBUG=1
（FLASK_ENV已弃用，别写） - 入口文件在
src/app.py？那FLASK_APP必须写成src.app，且项目必须用File → Open Folder打开整个文件夹，确保src在Python模块搜索路径里
Python解释器必须选对路径，且要验证是否真能import flask
VSCode底部状态栏显示的Python路径，必须指向你pip install flask的那个环境。列表里看到带venv字样的路径≠实际装了flask——很多人选完就以为万事大吉，结果新开终端一跑python -c "import flask"直接报错。
常见错误现象：ModuleNotFoundError: No module named 'flask'、解释器路径看着对，但pip list里没flask。
- 按
Ctrl+Shift+P→ 输入Python: Select Interpreter，从路径含venv、.venv或pyenv的选项里挑 - 选完后，新开集成终端，执行
python -c "import flask; print(flask.__version__)"，必须有输出才算真正生效 - 用Poetry？别选
poetry可执行文件，要选poetry env info --path返回路径下的python（通常在.venv/bin/python） - Windows用户注意：
venv\Scripts\python.exe是调试用的解释器路径，venv\Scripts\activate.bat是终端激活用的，别混
项目必须用Open Folder打开，不能只打开app.py
VSCode默认不把当前文件所在目录加进sys.path，flask run执行时找不到app.py或__init__.py里的app实例。这是绝大多数“为什么终端能跑VSCode跑不了”的根源。
常见错误现象：VSCode里点F5就报错，终端里cd到项目目录再flask run却一切正常。
- 必须用
File → Open Folder打开整个项目文件夹，确保app.py（或你指定的入口）在根目录下 - 项目根目录下必须有
app = Flask(__name__)这一行，且变量名是app（除非你用--app显式指定） - 集成终端不会自动继承你选的解释器，也不会自动激活虚拟环境——新开终端后，Windows要手动执行
.\venv\Scripts\activate，macOS/Linux执行source .venv/bin/activate
--no-reload和envFile路径的组合效果：断点不生效，90%是因为重载分叉了进程；Could not locate错误，八成是因为.env文件不在${workspaceFolder}下，或者VSCode根本没以文件夹形式打开项目。 
