Visual Studio 创建 Python 项目需三步到位:选对模板(如Flask/Django而非仅“Python应用程序”)、创建时启用虚拟环境(路径设为./venv且解释器指向.venv\Scripts\python.exe)、明确设置启动文件(右键文件→“设置为启动文件”或配置launchSettings.json),缺一将导致ModuleNotFoundError、调试失败或静默退出。

Visual Studio 创建 Python 项目不是“点一下就完事”的黑盒操作,关键在于选对模板、配对环境、确认启动文件——三者缺一不可。否则你会遇到 ModuleNotFoundError、ImportError、调试时找不到入口,甚至 python.exe 报错退出却无日志。
选模板:Python 应用 vs Flask/Django 模板的区别
新建项目时搜 python,别直接选第一个“Python 应用程序”就点创建——它只生成一个空 .py 文件,没环境、没依赖管理、没调试配置,适合写脚本,不适合工程化项目。
真实开发中应按需选:
- 写 Web 服务?选
空白Flask Web 项目或空白Django Web 项目:自带requirements.txt、WSGI 配置、调试启动器(launchSettings.json) - 做数据处理或 CLI 工具?选
Python 应用程序模板,但必须手动创建虚拟环境并安装包 - 已有代码想导入?用
从现有 Python 代码模板,注意它不复制文件,只建引用;路径填错会导致FileNotFoundError在运行时才暴露
配环境:虚拟环境必须在创建项目时就决定
Visual Studio 不会默认为你建虚拟环境,哪怕你选了 Flask 模板——它只提示:“检测到 requirements.txt,是否安装到虚拟环境?”。点“否”,包就装进全局 Python,后续换机器或协作极易出问题。
正确做法:
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
- 看到“安装到虚拟环境”弹窗 → 一定选它;若没弹窗,进
解决方案资源管理器右键项目 →添加 > 虚拟环境 - 虚拟环境路径建议设为项目根目录下
.venv,避免跨项目混用;路径含中文或空格会导致pip install失败 - 确认解释器路径是
.venv\Scripts\python.exe(Windows),不是C:\Python39\python.exe;可在Python 环境窗口里双击查看“解释器路径”
设启动文件:调试失败常因这个被忽略
很多新手以为只要代码能跑就行,结果 Ctrl+F5 一闪而过、断点不触发、终端没输出——大概率是没设启动文件。
Visual Studio 默认只把项目根目录下的 app.py(Flask)、manage.py(Django)或同名 .py(Python 应用程序)当启动项。如果你的主入口叫 main.py 或在子文件夹里:
- 在
解决方案资源管理器中找到该文件 → 右键 →设置为启动文件 - 若文件不在根目录,右键项目 →
属性→ “常规”页 → 修改启动文件字段为相对路径,如src/main.py - 检查
launchSettings.json是否存在且module或scriptPath值匹配;缺失会导致调试器静默失败
最易被忽略的点:项目创建后立即检查 Python 环境 窗口里的“包”选项卡,确认 flask、django 或你实际需要的包已安装成功——不要只看 requirements.txt 有内容就认为万事大吉。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










