You need to enable JavaScript to run this app. Windows 10环境下安装Flask后执行flask run提示命令未找到
优惠活动
大模型
产品
解决方案
定价
更多

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依赖,避免后续启动报导入错误)
  • 第二步:修正全局环境变量配置
    1. 执行命令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)
    2. 将该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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 03:36:01