Visual Studio 创建 Python Web 项目需确保 Python Web 支持已安装、requirements.txt 触发包安装、启动文件正确设置;缺一不可,否则项目无法运行。

Visual Studio 创建 Python 项目不是“选对模板就完事”,关键在于环境、模板和项目结构三者是否匹配——尤其容易卡在 Python Web 支持 未安装、requirements.txt 未触发安装、或启动文件未正确设置这三处。
找不到 Flask/Django 模板?检查 Python Web 支持是否已安装
Visual Studio 默认不带 Web 框架模板。即使装了 Python 开发 工作负载,也必须额外勾选 Python Web 支持,否则搜索 Flask 或 Django 会返回空结果。
- 打开 Visual Studio 安装程序 → 修改当前安装 → 勾选 “Python 开发” 工作负载下的
Python Web 支持 - 重启 VS 后,在 “创建新项目” 对话框中搜索
空白Flask Web 项目,而非仅搜Flask(后者可能匹配不到) - 若仍无结果,尝试切换筛选器:语言选
Python,项目类型选Web
创建后 requirements.txt 没自动安装包?手动触发或检查虚拟环境设置
VS 检测到 requirements.txt 后,会在顶部弹出提示条(如 “Python 包规范文件 ‘requirements.txt’ 在项目中检测到”),但这个提示默认不阻塞操作,很容易被忽略或直接关掉。
- 看到提示时,务必点击
创建虚拟环境(推荐)或安装到虚拟环境,而不是跳过 - 若没弹提示,可右键解决方案资源管理器中的项目 →
添加环境→ 选择Virtual Environment→ 接受默认路径 - 安装完成后,在
Python 环境窗口中确认Flask出现在已安装包列表里;否则右键该环境 →管理包→ 手动输入Flask安装
运行时报 ModuleNotFoundError 或直接黑窗闪退?检查启动文件是否设对
VS 不会自动把 app.py 或 manage.py 设为启动项,尤其用 “通用 Web 项目” 或 “从现有代码创建” 时,启动文件 字段常为空。
立即学习“Python免费学习笔记(深入)”;
- 在解决方案资源管理器中,找到你的主入口文件(如
app.py、hello.py或manage.py) - 右键该文件 →
设置为启动文件(不是 “设为启动项目”) - 确认项目属性 →
调试选项卡中,“启动浏览器” 和 “启动 URL” 是否填了(Web 项目需要);若留空,Ctrl+F5 可能只跑后台不启浏览器 - Flask 默认不启用 debug 模式,可在
app.run()中加参数:app.run(debug=True, host='127.0.0.1', port=5000)
最常被跳过的其实是虚拟环境初始化和启动文件绑定——这两步不手动点一下,项目看着创建成功了,实际根本跑不起来。


















