Flask怎么在PyCharm中配置虚拟环境

胖敏君_4851

胖敏君_4851

2026-09-19

252人浏览

原创

pycharm社区版不支持flask模板,必须手动创建虚拟环境并配置解释器:用python -m venv venv生成venv文件夹,再于settings中添加local interpreter指向venv/scripts/python.exe(windows)或venv/bin/python(macos/linux),确保app.py在项目根目录且flask_app环境变量设为app.py。

flask怎么在pycharm中配置虚拟环境

PyCharm社区版必须手动配虚拟环境

社区版不支持新建项目时自动创建 Flask 模板,也就没有“勾选 New environment using Virtualenv”的快捷入口。你看到的 no interpreter 提示不是警告,而是明确信号:解释器尚未绑定,Flask 肯定会报 ModuleNotFoundError: No module named 'flask'。这不是代码问题,是环境没接上。

关键点在于:虚拟环境目录(如 venv)和你的项目代码必须严格分离——app.py 绝不能放在 venv/ 里面,否则 PyCharm 根本不会扫描它,更别提识别 Flask。

  • 用命令行创建,路径清晰可控:python -m venv venv(Windows)或 python3 -m venv venv(macOS/Linux)
  • 如果提示 'python' is not recognized,就用绝对路径,比如 C:\Python39\python.exe -m venv venv
  • 创建完立刻验证:打开文件管理器,确认项目根目录下出现 venv 文件夹,且内部有 Scripts(Win)或 bin(macOS/Linux)子目录

PyCharm里怎么选对那个 python.exe

右下角点 no interpreterInterpreter SettingsAdd InterpreterAdd Local Interpreter,这一步最容易错在路径选错。

你要找的不是系统 Python,也不是 venv/ 文件夹本身,而是它里面的解释器可执行文件:

  • Windows:选 venv\Scripts\python.exe
  • macOS/Linux:选 venv/bin/python
  • 千万别选到 venv/Scripts/activatevenv/bin/activate——那是激活脚本,不是解释器
  • 选完点击 OK 后,PyCharm 会自动加载已安装包列表,此时你应该能在包列表里看到 flask

终端里没显示 (venv) 前缀?别急着重装

PyCharm 内置 Terminal 默认不会自动激活虚拟环境,哪怕解释器已经配对成功。这不代表环境坏了,只是终端没“上岗”。

Flask 3.0.2
Flask 3.0.2

Flask 3.0.2 是 Flask 的官方历史稳定版本,下载地址使用 PyPI wheel 包直链,适合指定版本安装和项目环境复现。

下载

两种处理方式:

  • 手动激活(推荐):在 Terminal 里运行 venv\Scripts\activate(Win)或 source venv/bin/activate(macOS/Linux),提示符前就会出现 (venv)
  • 让 PyCharm 自动激活:进入 Settings → Tools → Terminal,在 Shell path 里把默认 cmd.exezsh 改成带激活逻辑的命令,例如 Windows 可填:cmd.exe /k "venv\Scripts\activate.bat"
  • 注意:改 Shell path 后需重启 Terminal 标签页才生效

为什么 Flask 运行时报 FLASK_APP 未设置

这是 PyCharm 运行配置缺失的典型表现。即使解释器和包都对了,PyCharm 仍需要明确告诉 Flask “哪个文件是入口”。

解决方法很直接:

  • 点击右上角 Add Configuration(或 Edit Configurations)→ + → Flask Server
  • Target typeScript path,然后定位到你的 app.py(确保它在项目根目录,不是 venv/ 下)
  • Environment variables 里添加:FLASK_APP=app.py(值必须是文件名,不含路径)
  • 如果用了 if __name__ == '__main__': app.run() 方式启动,就不用设 FLASK_APP,但调试器无法热重载,开发效率低

最常被忽略的是:app.py 文件名必须和 FLASK_APP 环境变量值完全一致,大小写、后缀都不能错;一旦改名,这里必须同步更新。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
flask框架如何搭建
flask框架如何搭建

搭建步骤:1、安装Python和Pip;2、创建虚拟环境;3、安装Flask;4、创建Flask应用;5、运行应用;6、访问应用。想了解更多flask框架的相关内容,可以阅读本专题下面的文章。

2024.06.27

2795

8

Python Flask框架
Python Flask框架

本专题专注于 Python 轻量级 Web 框架 Flask 的学习与实战,内容涵盖路由与视图、模板渲染、表单处理、数据库集成、用户认证以及RESTful API 开发。通过博客系统、任务管理工具与微服务接口等项目实战,帮助学员掌握 Flask 在快速构建小型到中型 Web 应用中的核心技能。

2025.08.25

4124

10

Python Flask Web框架与API开发
Python Flask Web框架与API开发

本专题系统介绍 Python Flask Web框架的基础与进阶应用,包括Flask路由、请求与响应、模板渲染、表单处理、安全性加固、数据库集成(SQLAlchemy)、以及使用Flask构建 RESTful API 服务。通过多个实战项目,帮助学习者掌握使用 Flask 开发高效、可扩展的 Web 应用与 API。

2025.12.15

256

16

pycharm怎么改成中文
pycharm怎么改成中文

PyCharm是一种Python IDE(Integrated Development Environment,集成开发环境),带有一整套可以帮助用户在使用Python语言开发时提高其效率的工具,比如调试、语法高亮、项目管理、代码跳转、智能提示、自动完成、单元测试、版本控制。此外,该IDE提供了一些高级功能,以用于支持Django框架下的专业Web开发。php中文网给大家带来了pycharm相关的教程以及文章,欢迎大家前来学习和阅读。

2023.07.25

2229

3

pycharm安装教程
pycharm安装教程

PyCharm是一款由JetBrains开发的Python集成开发环境(IDE),它提供了许多方便的功能和工具。本专题为大家带来pycharm安装教程,帮助大家解决问题。

2023.08.21

4117

4

如何解决pycharm找不到模块
如何解决pycharm找不到模块

解决pycharm找不到模块的方法:1、检查python解释器;2、安装缺失的模块;3、检查项目结构;4、检查系统路径;5、使用虚拟环境;6、重启PyCharm或电脑。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.12.04

718

5

如何安装pycharm
如何安装pycharm

安装pycharm的步骤:1、访问PyCharm官方网站下载最新版本的PyCharm;2、下载完成后,打开安装文件;3、安装完成后,打开PyCharm;4、在PyCharm的主界面中等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

654

5

python和pycharm的区别
python和pycharm的区别

Python和PyCharm是两个不同的概念,它们的区别如下:1、Python是一种编程语言,而PyCharm是一款Python集成开发环境;2、Python可以运行在各种不同的开发环境中,而PyCharm是专门为Python开发而设计的IDE等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

467

5

pycharm环境如何配置
pycharm环境如何配置

配置教程:1、下载并安装PyCharm;2、选择Python解释器;3、配置虚拟环境;4、配置代码风格;5、配置调试器;6、配置版本控制工具;7、配置插件;8、配置Python路径和环境变量;9、配置其他选项。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

482

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Flask-Migrate数据库迁移文档
Flask-Migrate数据库迁移文档

共0课时 | 0人学习

Flask官方快速入门文档
Flask官方快速入门文档

共0课时 | 0人学习