Windows 10环境下安装Flask后执行flask run提示命令未找到
问题核心成因
报错bash: flask: command not found的本质是当前终端的环境变量PATH未包含Python安装目录下的Scripts子路径,系统无法定位pip安装Flask时自动生成的flask可执行入口文件。
分步排查与解决方案
- 第一步:验证Flask安装状态
执行命令pip show Flask:- 可正常输出Flask版本、安装路径等信息,说明安装流程无异常,继续后续排查
- 提示找不到对应包则重新执行安装命令:
pip install flask python-dotenv(需同步安装代码中引用的dotenv依赖,避免后续启动报导入错误)
- 第二步:修正全局环境变量配置
- 执行命令
python -c "import sys; print(sys.executable)"获取当前正在使用的Python解释器绝对路径,例如输出为C:\Users\用户名\AppData\Local\Programs\Python\Python39\python.exe,则对应的Scripts子目录路径为同层级下的Scripts文件夹(即C:\Users\用户名\AppData\Local\Programs\Python\Python39\Scripts) - 将该Scripts路径添加到系统环境变量的PATH列表中,保存配置后完全关闭所有已打开的终端窗口,重新在项目目录打开终端,执行
flask --version验证是否能正常输出版本信息
- 执行命令
- 第三步:临时替代启动方案(无需修改全局环境变量)
直接通过Python模块调用的方式启动Flask服务,完全绕开全局命令入口的PATH依赖,执行命令:python -m flask run
该方式不受PATH配置影响,只要Python解释器能正常调用,就能找到对应Flask模块执行启动逻辑。
项目启动的额外配置注意事项
- 启动前需指定Flask应用的入口文件:Windows cmd终端执行
set FLASK_APP=app.py,Git Bash类的bash终端执行export FLASK_APP=app.py,否则Flask无法定位到你的应用实例 - 项目代码中通过
os.getenv('hostname')读取环境变量时,需在项目根目录(和app.py同层级)创建.env文件,写入格式为hostname=实际配置值的内容,否则读取到的变量值为空
内容的提问来源于stack exchange,提问作者Kabir
相关产品推荐
相关产品推荐

