PyCharm中FLASK_DEBUG选项仅在专业版新建Flask项目时自动生成；手动创建或导入项目需手动添加FLASK_DEBUG=1等环境变量，或通过Additional options传--host=0.0.0.0 --port=8000参数，且必须点击配置面板的▶️运行按钮而非右键Run，才能使flask run命令正确读取环境变量与CLI参数。
PyCharm里找不到FLASK_DEBUG选项
不是所有项目都能直接看到 FLASK_DEBUG 配置项——只有用 PyCharm 专业版「新建 Flask 项目」时，才会自动生成带 Flask 支持的运行配置。如果你是手动新建 Python 项目或从 Git 拉取的代码，PyCharm 默认只识别为普通 Python 脚本，FLASK_DEBUG、FLASK_APP 这类环境变量不会出现在 Edit Configurations 界面。
解决办法只有两个：
- 删掉现有配置，重新点左上角“+” → 选择
Flask Server（不是 Python Script），再填Script path指向你的app.py - 或者退而求其次，在
Environment variables区域手动加：FLASK_DEBUG=1和FLASK_APP=app.py
注意：如果 app.py 不在项目根目录，FLASK_APP 必须写成模块路径形式，比如 src.main:app（冒号前是包路径，后是 Flask 实例变量名）。
host=0.0.0.0 和 port=8000 怎么生效
PyCharm 的 Flask 运行配置里没有 host/port 输入框，不能直接填。必须通过 Additional options 栏传参：
- 填
--host=0.0.0.0 --port=8000（中间空格分隔，等号不加空格） - 别写成
--host 0.0.0.0，flask 命令不认这种空格分隔写法 - 如果同时启用了 debug 模式，
--debug参数可省略，因为FLASK_DEBUG=1已覆盖
配完一定要点击右上角的 ▶️ 运行按钮（而不是右键 Run），否则新参数不会加载。
为什么改了 config['DEBUG']=True 却没效果
这是新手最常踩的坑：app.config['DEBUG'] = True 只在调用 app.run() 时起作用，但 PyCharm 默认用的是 flask run 命令启动（即通过命令行入口），此时它完全忽略代码里的 app.config 设置，只认环境变量。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
所以这三者互不影响：
-
app.run(debug=True)—— 仅当直接执行python app.py时生效 -
app.config['DEBUG'] = True—— 同上，且必须在app.run()调用前设置 -
FLASK_DEBUG=1——flask run唯一认的开关，PyCharm 默认走这条路
结论：PyCharm 里想开 debug，优先设环境变量，别依赖代码赋值。
虚拟环境和解释器选错导致 ImportError
即使你 pip install flask 成功，PyCharm 还是报 ModuleNotFoundError: No module named 'flask'，大概率是解释器没对上。
检查步骤：
- 点
File → Settings → Project → Python Interpreter，确认右上角显示的 interpreter 路径和你pip install flask时激活的虚拟环境一致 - 如果路径是系统 Python（如
C:\Python39\python.exe），那装的 flask 就不在那儿 - Terminal 底部状态栏显示的环境名（如
(venv)）和 Settings 里选的必须一致
特别提醒：FLASK_APP 找不到模块时，错误信息里会明确写 Could not import "xxx"，这时候先验证 import flask 是否成功，再查路径和模块名拼写。
