真正启动Python项目需确保解释器、依赖、路径、工作目录四者对齐；code .仅打开VSCode，python main.py等命令才实际运行代码，推荐先终端验证再配置VSCode。
直接在终端里敲 code . 并不能运行 Python 项目，它只是打开编辑器；真正要“启动项目”，得区分清楚：你是想打开项目目录，还是想运行代码，还是想一键拉起开发环境（含虚拟环境、服务、调试等）。下面按真实使用场景拆解。
用 code 命令打开 Python 项目目录
这是最基础也最容易被当成“启动项目”的操作——其实只是启动 VSCode 并加载工作区。
-
code命令必须已加入系统 PATH（macOS/Linux 默认装好；Windows 安装时勾选“Add to PATH”才可用） - 进到项目根目录后执行
code .，VSCode 就会以当前文件夹为工作区打开 - 如果项目含
.vscode/settings.json或pyproject.toml，VSCode 会自动识别 Python 解释器和格式化配置 - 别用
code /path/to/project打开子目录——可能导致 Python 插件找不到venv或requirements.txt
用 python 命令直接运行脚本（不依赖 VSCode）
VSCode 的“运行”本质仍是调用系统 Python 解释器。绕过界面，终端里跑得更快、更可控。
- 确保当前终端已激活虚拟环境（如
source venv/bin/activate或venvScriptsctivate.bat） - 运行单个文件：
python main.py—— 注意不是python ./main.py，路径写法在某些 shell 下会出错 - 带参数运行：
python script.py --env dev --port 8000 - 如果报错
ModuleNotFoundError，大概率是没激活虚拟环境，或当前目录不是包的根目录（Python 的sys.path不包含子目录）
配置 tasks.json 实现 Ctrl+Shift+B 一键运行
适合固定入口、需重复执行的场景（比如每次改完都 run server），比右键菜单更稳定，也支持传参和错误定位。
立即学习“Python免费学习笔记（深入）”；
- 按
Ctrl+Shift+P→ 输入Tasks: Configure Task→ 选Create tasks.json file from template→Others - 替换内容为：
{
"version": "2.0.0",
"tasks": [
{
"label": "run dev",
"type": "shell",
"command": "${command:python.interpreterPath}",
"args": ["${file}"],
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false
}
}
]
}
-
${command:python.interpreterPath}动态读取 VSCode 当前选中的解释器路径，避免硬编码（比如C:\Python311\python.exe）导致跨机器失效 -
${file}表示当前活动编辑器的文件路径；如需固定运行app.py，改成"${workspaceFolder}/app.py" - 保存后按
Ctrl+Shift+B，选run dev即可——终端自动弹出并执行
为什么推荐先手动跑通再配 VSCode
很多新手卡在“点绿色三角没反应”或“输出空白”，其实问题根本不在 VSCode，而在环境本身。
- 先在终端里确认：
which python（macOS/Linux）或where python（Windows）是否指向你期望的解释器 - 检查
pip list是否有项目依赖（比如flask），没有就pip install -r requirements.txt - 确认
print()语句是否真的执行了——有些脚本跑完立刻退出，终端闪退，容易误判为“没运行” - VSCode 的 Python 插件有时缓存旧解释器路径，改完
venv后务必按Ctrl+Shift+P→Python: Select Interpreter重新选一次
真正的“启动项目”从来不是点一下按钮，而是让解释器、依赖、路径、工作目录这四者对齐。VSCode 只是把它们串起来的胶水，胶水再好，木头没对齐也白搭。
